home *** CD-ROM | disk | FTP | other *** search
Text File | 1986-11-16 | 297.3 KB | 8,608 lines
This is file: FCONSOLE.DOC. You may read it on-line using TYPE. You may also PRINT it on most printers, if you first set them to print at least 62 lines per page (no perforation skip). It contains overprinted and underlined lines and tab characters. On some printers, you must turn bi-directional printing off. FANSI-CONSOLE (tm) _____________ ____ FANSI-CONSOLE (tm) The Integrated Console Utility (tm) ___ __________ _______ _______ ____ The Integrated Console Utility (tm) User Manual User Manual Version 2.00 - October 18th, 1986 Version 2.00 - October 18th, 1986 No Smoking Software (tm) __ _______ ________ ____ No Smoking Software (tm) (C) Copyright 1984-1986 (C) Copyright 1984-1986 Hersey Micro Consulting, Inc. Hersey Micro Consulting, Inc. P.O. Box 8276 P.O. Box 8276 Ann Arbor, Michigan USA 48107 Ann Arbor, Michigan USA 48107 (313)-994-3259 Voice (313)-994-3259 Voice (313)-994-3946 BBS (Mon-Sun 24 HRS) (313)-994-3946 BBS (Mon-Sun 24 HRS) ISBN 0-933737-01-7 ISBN 0-933737-01-7 FANSI-CONSOLE NOT _____________ FANSI-CONSOLE is NOT a free program. It is professional software FANSI- ______ written by professional programmers. Usage and copying of FANSI- CONSOLE _______ CONSOLE and its abbreviated user manual are subject to extremely friendly licensing terms found within this manual. Dedicated in memory of Ralph Emerson Hersey, inventor, pioneer in the communications industry, and proud grandfather. In his day, he solved some of the world's problems. We hope we may all do the same in ours. We can still hear him say, "That's the system". FANSI (tm) FANSI-CONSOLE (tm) The Integrated Console Utility (tm) _____ ____ _____________ ____ ___ __________ _______ _______ ____ FANSI (tm), FANSI-CONSOLE (tm), The Integrated Console Utility (tm), FANSI-RAMDISK (tm) MODEM86 (tm) No Smoking Software (tm) _____________ ____ _______ ____ __ _______ ________ ____ FANSI-RAMDISK (tm), MODEM86 (tm), No Smoking Software (tm), and Hersey Micro Consulting (tm) ______ _____ __________ ____ Hersey Micro Consulting (tm) are trademarks of Hersey Micro ANSI Consulting, Inc. ANSI is a trademark of American National Standards DEC VT52 VT100 Institute. DEC, VT52 and VT100 are trademarks of Digital Equipment IBM IBM-PC IBM-PC DOS Corporation. IBM IBM-PC, and IBM-PC DOS are registered trademarks Microsoft MS-DOS of International Business Machines Corporation. Microsoft and MS-DOS are trademarks of Microsoft Corporation. Most other names of products mentioned in this manual are also trademarks of various other companies, as noted. Table of Contents Table of Contents Chapter 1 Introduction 1-1 FANSI-CONSOLE _____________ 1.1 What is FANSI-CONSOLE? . . . . . . . . . . . . . . . . . 1-1 FANSI-CONSOLE _____________ 1.2 What does FANSI-CONSOLE do? . . . . . . . . . . . . . . 1-2 1.2.1 Compatibly replaces standard IBM-PC console software . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 1.2.2 Speeds up screen writing . . . . . . . . . . . . . 1-3 1.2.3 Processes more ANSI X3.64 control sequences . . . . 1-4 1.2.4 Emulates DEC VT100 . . . . . . . . . . . . . . . . 1-5 1.2.5 Allows one finger pausing . . . . . . . . . . . . . 1-6 1.2.6 Allows more control over shifting and locking keys . 1-6 1.2.7 Allows recall of lines scrolled off the screen . . 1-6 1.2.8 Allows much more type ahead . . . . . . . . . . . . 1-7 1.2.9 Allows keyboard macro assignment during running programs . . . . . . . . . . . . . . . . . . . . . . . . . 1-8 1.2.10 Allows more memory for keyboard macros . . . . . . 1-8 1.2.11 Turns displays off when not in use . . . . . . . . 1-8 1.2.12 Allows one finger typing . . . . . . . . . . . . . 1-8 1.2.13 Allows keyboard generated breakpoints . . . . . . 1-9 1.2.14 Eliminates screen flicker . . . . . . . . . . . . 1-9 1.2.15 Provides support for displays with more rows and columns . . . . . . . . . . . . . . . . . . . . . . . . . 1-9 1.2.16 Extends the IBM-PC ROM BIOS . . . . . . . . . . . 1-10 1.2.17 Provides some control over use of color . . . . . 1-10 1.2.18 Provides control over key repeat rate . . . . . . 1-10 1.2.19 Provides control over key clicks . . . . . . . . . 1-11 1.2.20 Other features . . . . . . . . . . . . . . . . . . 1-11 FANSI- ______ 1.3 What about multitasking windowing programs and FANSI- CONSOLE _______ CONSOLE? . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12 Chapter 2 Starting Quickly 2-1 FANSI-CONSOLE _____________ 2.1 Do I have to read the whole FANSI-CONSOLE user manual? . 2-1 2.1.1 NO! . . . . . . . . . . . . . . . . . . . . . . . . 2-1 FANSI-CONSOLE _____________ 2.2 How do I quickly install FANSI-CONSOLE? . . . . . . . . 2-3 2.2.1 Verify distribution diskettes . . . . . . . . . . . 2-3 2.2.2 Backup distribution diskettes . . . . . . . . . . . 2-7 2.2.3 Backup system disks . . . . . . . . . . . . . . . . 2-7 2.2.4 Copy FCONSOLE.DEV to system disk . . . . . . . . . 2-8 2.2.5 Add DEVICE=FCONSOLE.DEV to CONFIG.SYS . . . . . . . 2-8 2.2.6 Remove DEVICE=ANSI.SYS from CONFIG.SYS . . . . . . 2-9 2.2.7 Leave enough memory for applications programs . . . 2-10 2.2.8 Restart MS-DOS . . . . . . . . . . . . . . . . . . 2-11 2.2.9 Add BUFFERS=20 to CONFIG.SYS . . . . . . . . . . . 2-12 2.2.10 Modify Prompt . . . . . . . . . . . . . . . . . . 2-13 2.2.11 Add TYPE FANSISET.TXT to AUTOEXEC.BAT . . . . . . 2-15 FANSI-CONSOLE _____________ 2.3 How do I use FANSI-CONSOLE? . . . . . . . . . . . . . . 2-16 i 2.3.1 Using the Ctrl-F key . . . . . . . . . . . . . . . 2-16 2.3.2 Using the Ctrl-S key . . . . . . . . . . . . . . . 2-16 2.3.3 Using the Ctrl-Num-Lock key . . . . . . . . . . . . 2-17 2.3.4 Using the Ctrl-C or Ctrl-Break keys . . . . . . . . 2-17 2.3.5 Using the Alt-Ctrl-Grave key . . . . . . . . . . . 2-17 __ FANSI-CONSOLE _____________ 2.4 How do I uninstall FANSI-CONSOLE? . . . . . . . . . . . 2-19 Chapter 3 Detailed Installation 3-1 3.1 So what is an MS-DOS device driver, anyway? . . . . . . 3-1 3.2 What if my needs are ... different? . . . . . . . . . . 3-3 FANSI-CONSOLE _____________ 3.3 How much memory does FANSI-CONSOLE require? . . . . . . 3-32 Chapter 4 Programming Background 4-1 4.1 Which screen writing method is best? . . . . . . . . . . 4-1 FANSI-CONSOLE _____________ 4.2 How do I detect whether FANSI-CONSOLE is installed? . . 4-4 Chapter 5 Using Control Sequences 5-1 5.1 Why use control sequences? . . . . . . . . . . . . . . . 5-1 5.2 What is a control sequence? . . . . . . . . . . . . . . 5-3 5.3 How do I put control sequences in a file? . . . . . . . 5-6 5.4 How do I use control sequences in batch files? . . . . . 5-7 5.4.1 Using the ECHO command . . . . . . . . . . . . . . 5-7 5.4.2 Using the PROMPT command . . . . . . . . . . . . . 5-8 5.4.3 Using the SEND command . . . . . . . . . . . . . . 5-9 5.5 How are control sequences represented? . . . . . . . . . 5-15 5.6 How can my program write control sequences? . . . . . . 5-18 5.6.1 BASIC . . . . . . . . . . . . . . . . . . . . . . . 5-19 5.6.2 C . . . . . . . . . . . . . . . . . . . . . . . . . 5-20 5.6.3 PASCAL . . . . . . . . . . . . . . . . . . . . . . 5-21 5.6.4 Assembly Language . . . . . . . . . . . . . . . . . 5-22 FANSI-CONSOLE _____________ 5.7 What standards does FANSI-CONSOLE support? . . . . . . . 5-25 5.7.1 ANSI X3.4 - 1977 . . . . . . . . . . . . . . . . . 5-25 5.7.2 ANSI X3.32 - 1973 . . . . . . . . . . . . . . . . . 5-26 5.7.3 ANSI X3.41 - 1974 . . . . . . . . . . . . . . . . . 5-26 5.7.4 ANSI X3.134 . . . . . . . . . . . . . . . . . . . . 5-27 5.7.5 ANSI X3.64 - 1979 . . . . . . . . . . . . . . . . . 5-27 5.7.6 ISO 2022 - 1973 . . . . . . . . . . . . . . . . . . 5-28 5.7.7 ISO 2375 . . . . . . . . . . . . . . . . . . . . . 5-28 5.7.8 DEC VT100 . . . . . . . . . . . . . . . . . . . . . 5-29 Chapter 6 ANSI X3.64 Control Sequences 6-1 6.1 Why use ANSI X3.64 control sequences? . . . . . . . . . 6-1 6.2 How do I find out the name of a control sequence? . . . 6-2 6.2.1 Control Functions . . . . . . . . . . . . . . . . . 6-2 6.2.2 Parameter Values . . . . . . . . . . . . . . . . . 6-4 6.3 What can the control sequences do? . . . . . . . . . . . 6-7 6.4 How do I find out the mnemonic for an ANSI X3.64 control sequence? . . . . . . . . . . . . . . . . . . . . . . . . . . 6-75 6.5 How do I find out the syntax of an ANSI X3.64 control sequence? . . . . . . . . . . . . . . . . . . . . . . . . . . 6-80 Chapter 7 ISO 2022 control sequences 7-1 7.1 Why use ISO 2022? . . . . . . . . . . . . . . . . . . . 7-1 7.2 How is IBM's ANSI.SYS not ISO 2022 standard? . . . . . . 7-3 7.3 How do I specify graphic character sets using ISO 2022? . 7-4 ii 7.3.1 Background . . . . . . . . . . . . . . . . . . . . 7-4 7.3.2 Character Set Designaters . . . . . . . . . . . . . 7-8 7.3.3 Shifts . . . . . . . . . . . . . . . . . . . . . . 7-10 7.3.4 Facilities Announcers . . . . . . . . . . . . . . . 7-11 Chapter 8 ISO 2022 control sequences 8-1 8.1 Why use ISO 2022? . . . . . . . . . . . . . . . . . . . 8-1 8.2 How is IBM's ANSI.SYS not ISO 2022 standard? . . . . . . 8-3 8.3 How do I specify graphic character sets using ISO 2022? . 8-4 8.3.1 Background . . . . . . . . . . . . . . . . . . . . 8-4 8.3.2 Character Set Designaters . . . . . . . . . . . . . 8-8 8.3.3 Shifts . . . . . . . . . . . . . . . . . . . . . . 8-10 8.3.4 Facilities Announcers . . . . . . . . . . . . . . . 8-11 Chapter 9 ROM BIOS Calls 9-1 9.1 Do I have to change my ROM BIOS calls? . . . . . . . . . 9-1 9.2 How do I make keyboard BIOS calls? . . . . . . . . . . . 9-3 9.3 How do I make screen BIOS calls? . . . . . . . . . . . . 9-10 Chapter 10 Scroll Recall 10-1 10.1 How do I use the scroll recall feature? . . . . . . . . 10-1 10.2 How do I use recall buffer highlighting? . . . . . . . 10-5 10.3 How do I reenter lines from the recall buffer? . . . . 10-7 10.4 How do I print the recall buffer on a printer? . . . . 10-8 10.5 How do I keep the recall buffer from filling? . . . . . 10-9 10.6 How do I write the recall buffer to a file? . . . . . 10-10 Chapter 11 Keyboard Arrangement 11-1 11.1 How do I get a Dvorak keyboard arrangement? . . . . . . 11-1 11.2 How do I get back the normal keyboard arrangement? . . 11-2 11.3 How do I rearrange my keyboard keys? . . . . . . . . . 11-3 FANSI-CONSOLE _____________ 11.4 How do I assign macros to FANSI-CONSOLE keys? . . . . . 11-7 11.5 How do I get the console into local mode? . . . . . . 11-10 11.6 How do I make a key generate an control sequence? . . 11-11 11.7 How do I use the original definition of a key? . . . 11-12 FANSI-CONSOLE _____________ 11.8 How do I get FANSI-CONSOLE to emulate a VT100? . . . 11-13 Chapter 12 Advanced Features 12-1 12.1 How do I induce breakpoints with the keyboard? . . . . 12-1 Chapter 13 Compatibility and Limitations 13-1 FANSI-CONSOLE _____________ 13.1 What do I do if FANSI-CONSOLE gives me problems? . . . 13-1 13.1.1 Check for the problem in the index under "problem" . . . . . . . . . . . . . . . . . . . . . . . . 13-1 13.1.2 Check the compatibility lists . . . . . . . . . . 13-1 FANSI-CONSOLE _____________ 13.1.3 Check for problems without FANSI-CONSOLE . . . . . 13-2 13.1.4 Check for lack of memory problems . . . . . . . . 13-2 13.1.5 Check for interaction problems . . . . . . . . . . 13-3 13.1.6 When all else fails....give us a call . . . . . . 13-4 FANSI-CONSOLE _____________ 13.2 What limitations does FANSI-CONSOLE have? . . . . . . . 13-5 FANSI-CONSOLE _____________ 13.3 Are there several versions of FANSI-CONSOLE? . . . . . 13-6 FANSI-CONSOLE _____________ 13.4 What programs are compatible with FANSI-CONSOLE? . . . 13-7 FANSI-CONSOLE _____________ 13.5 What computers are compatible with FANSI-CONSOLE? . . 13-13 __ FANSI-CONSOLE _____________ 13.6 What programs are incompatible with FANSI-CONSOLE? . 13-16 __ FANSI-CONSOLE _____________ 13.7 What computers are incompatible with FANSI-CONSOLE? . 13-20 iii 13.8 How do I help you solve compatibility problems? . . . 13-23 13.8.1 How to use redirection . . . . . . . . . . . . . 13-23 13.8.2 How to use TRAP . . . . . . . . . . . . . . . . 13-24 13.8.3 How to use WATZITBE and WATZITDO . . . . . . . . 13-25 Chapter 14 Credits 14-1 14.1 How did you do that? . . . . . . . . . . . . . . . . . 14-1 Chapter 15 Distribution and Licensing 15-1 FANSI-CONSOLE _____________ 15.1 You mean FANSI-CONSOLE is not freeware? . . . . . . . . 15-1 FANSI-CONSOLE _____________ 15.2 How are you limiting my use of FANSI-CONSOLE? . . . . . 15-2 15.2.1 Limitations . . . . . . . . . . . . . . . . . . . 15-2 15.2.2 Rights . . . . . . . . . . . . . . . . . . . . . . 15-5 FANSI-CONSOLE _____________ 15.3 How do I know if FANSI-CONSOLE is right for me? . . . . 15-6 15.3.1 DISCLAIMER . . . . . . . . . . . . . . . . . . . . 15-6 15.4 What do we pay if we have more than one computer? . . . 15-7 FANSI-CONSOLE _____________ 15.5 Can I get a printed complete FANSI-CONSOLE user manual? . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-8 FANSI-CONSOLE _____________ 15.6 How do I get updated versions of FANSI-CONSOLE? . . . . 15-9 FANSI-CONSOLE _____________ 15.7 Can I publish FANSI-CONSOLE? . . . . . . . . . . . . 15-11 FANSI-CONSOLE _____________ 15.8 Can I buy the FANSI-CONSOLE program source? . . . . . 15-11 iv FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction Chapter 1 Chapter 1 Introduction Introduction 1.1 What is FANSI-CONSOLE? _____________ 1.1 What is FANSI-CONSOLE? FANSI-CONSOLE (tm) _____________ ____ Briefly, FANSI-CONSOLE (tm) is a fast ANSI X3.64 standard console driver for the IBM-PC. The name "FANSI" comes from "fast ANSI". Pronounce it the same as "fancy". The "console" means the screen and FANSI-CONSOLE _____________ keyboard together. We also call FANSI-CONSOLE "The Integrated Console (tm) ____ Utility (tm)", because it integrates many little console control features into one program. FANSI-CONSOLE _____________ FANSI-CONSOLE runs under MS-DOS. We use "MS-DOS" as the name for Microsoft's MS-DOS, of which IBM-PC DOS is a variant. FANSI-CONSOLE _____________ This chapter gives an overview of what FANSI-CONSOLE can do for you. FANSI-CONSOLE _____________ It explains why you will want to use FANSI-CONSOLE. The next chapter FANSI-CONSOLE _____________ tells you how to get started, so that you can try FANSI-CONSOLE right away. (C) Copyright 1984-86 Hersey Micro Consulting 1-1 (C) Copyright 1984-86 Hersey Micro Consulting 1-1 FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction 1.2 What does FANSI-CONSOLE do? _____________ 1.2 What does FANSI-CONSOLE do? 1.2.1 Compatibly replaces standard IBM-PC console software _____ __________ ________ ________ ______ _______ ________ 1.2.1 Compatibly replaces standard IBM-PC console software FANSI-CONSOLE _____________ FANSI-CONSOLE is both an MS-DOS console driver and a BIOS console driver. These are two somewhat similar but still different things. It is somewhat like an actor playing the parts of both twins in a movie. FANSI-CONSOLE _____________ FANSI-CONSOLE plays the part of the standard IBM-PC ROM BIOS console software. It also plays the part of the standard IBM-PC MS-DOS console device driver (or the standard IBM-PC ANSI.SYS device FANSI-CONSOLE _____________ driver). FANSI-CONSOLE replaces the screen and keyboard handling parts of both the IBM-PC ROM BIOS and MS-DOS 2.00 (and later versions). It is a complete and mostly compatible replacement for the standard IBM-PC console software, but offers many significant improvements. It also replaces many other small single feature console utilities you can find in the public domain and on the retail market. FANSI-CONSOLE _____________ Although we try to make FANSI-CONSOLE as compatible as possible to the standard IBM-PC console software, please note that because of the FANSI-CONSOLE _____________ improvements offered, it is impossible for FANSI-CONSOLE to be 100% compatible. For program compatibility information, see the chapter entitled "Compatibility and Limitations". We hope to extend the compatibility list, as more people report how well it works with other software. FANSI-CONSOLE _____________ Just like MS-DOS, FANSI-CONSOLE always resides in memory once MS-DOS FANSI-CONSOLE ________ _____________ places it there during the start up process. FANSI-CONSOLE requires _____ __ __ __ __________ ______ about 32 KB of read/write memory for itself. In comparison, the standard IBM-PC ANSI.SYS device driver requires about 1.6 KB of FANSI-CONSOLE not _____________ ___ read/write memory for itself. FANSI-CONSOLE does not require any special hardware like a second diskette drive or a fixed disk. It performs just as well without them as with them. FANSI-CONSOLE _____________ FANSI-CONSOLE works on computers and display adapters hardware equivalent to the IBM-PC and the IBM Monochrome Display and Printer Adapter or the IBM Color Graphics Adapter. People often call these computers and adapters "compatibles" or "clones". We prefer the term FANSI-CONSOLE _____________ clone. Note that, because of the nature of the program, FANSI-CONSOLE ___ ___ does not work on computers not hardware equivalent to the IBM-PC. For hardware compatibility information, see the chapter entitled "Compatibility and Limitations". We hope to extend the compatibility list, as more people report how well it works on other computers. FANSI-CONSOLE _____________ With any luck, FANSI-CONSOLE will become a standard by which IBM-PC FANSI-CONSOLE _____________ compatibility is measured. Of particular note is that FANSI-CONSOLE now fully supports all the modes of the IBM Enhanced Graphics Adapter (EGA) and its clones. (C) Copyright 1984-86 Hersey Micro Consulting 1-2 (C) Copyright 1984-86 Hersey Micro Consulting 1-2 FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction 1.2.2 Speeds up screen writing _____ ______ __ ______ _______ 1.2.2 Speeds up screen writing We call the process of filling the screen with information by FANSI- ______ "writing" to it "screen writing". The most basic feature of FANSI- CONSOLE _______ CONSOLE is that it speeds up the screen writing of many programs. This includes all MS-DOS internal commands like TYPE and DIR. Any program which uses standard MS-DOS or IBM-PC ROM BIOS calls to write to the PC screen, instead of direct hardware manipulation, writes to __ ____ __ ___ _____ __ ____ FANSI- ______ the screen as much as ten times as fast as it does without FANSI- CONSOLE _______ CONSOLE. Most speed ups that we have tested in our MS-DOS TYPE command benchmarks range between 1.4 and 6.0 times as fast with FANSI-CONSOLE FANSI- _____________ ______ FANSI-CONSOLE's quick mode with hardware scrolling. With FANSI- CONSOLE _______ CONSOLE's default, non-quick, mode with more compatible software scrolling, the speed ups mostly range between 1.2 and 2.0 times as FANSI-CONSOLE _____________ fast. FANSI-CONSOLE does not always speedup application programs as much as that, because of additional overhead in the application FANSI-CONSOLE _____________ programs themselves. FANSI-CONSOLE usually does not affect those which write directly to the IBM-PC screen memory, but see the FANSI-CONSOLE _____________ discussion below about screen flicker. FANSI-CONSOLE does not slow down an application program's screen writing, unless that program directly modifies BIOS read/write memory variables, or you enable the FANSI-CONSOLE FANSI-CONSOLE _____________ _____________ FANSI-CONSOLE scroll recall feature. In most cases, FANSI-CONSOLE is faster even when you enable the scroll recall feature. This means much less waiting for menus and so on to be written onto the screen. FANSI-CONSOLE _____________ Generally, FANSI-CONSOLE speeds up the programs that write to the FANSI-CONSOLE _____________ screen slowly to begin with. FANSI-CONSOLE speeds up programs written to run on any MS-DOS computer. Programs that write to the screen quickly to begin with nearly always write directly to the screen FANSI-CONSOLE ___ FANSI-CONSOLE _____________ _____________ memory, and FANSI-CONSOLE does not affect them. Also, FANSI-CONSOLE does not affect any program that causes hashing (snow) on a standard IBM-PC Color Graphics Adapter, because they write directly to screen FANSI-CONSOLE _____________ memory. For information about which programs FANSI-CONSOLE speeds up, see the compatibility list contained within the chapter entitled "Compatibility and Limitations". The speed up amount depends upon: FANSI-CONSOLE _____________ - the various FANSI-CONSOLE option settings, - how much overhead the application program itself adds to the screen writing, - the type of display adapter, - the screen display mode, - the type of screen writing calls, - whether the application uses scrolling, - what brand of clone computer you have, FANSI-CONSOLE _____________ - and whether FANSI-CONSOLE replaces other single feature console utilities as well as the standard IBM-PC console software. (C) Copyright 1984-86 Hersey Micro Consulting 1-3 (C) Copyright 1984-86 Hersey Micro Consulting 1-3 FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction FANSI-CONSOLE _____________ FANSI-CONSOLE generally speeds up those Color Graphics Adapters which do not require screen memory writing to be delayed until a horizontal retrace, more than the standard IBM-PC Color Graphics Adapter. It generally speeds up monochrome adapters more than the standard IBM-PC Color Graphics Adapter, except that it does not support hardware scrolling on most monochrome adapters. Some clone computers' BIOSes FANSI-CONSOLE _____________ are slower than others, and FANSI-CONSOLE speeds up these more than the fast ones. FANSI-CONSOLE _____________ FANSI-CONSOLE generally speeds up the character screen display modes more than the graphics screen display modes. It generally speeds up DOS calls more than BIOS calls. It generally speeds up programs that require no scrolling more than those requiring scrolling. The best FANSI-CONSOLE _____________ part is that the modes FANSI-CONSOLE speeds up the most are the screen display modes most frequently used: the character modes with no scrolling. Most single feature console utilities have the bad side effect that they slow down the screen writing a bit. The more of these single FANSI-CONSOLE _____________ feature console utilities you replace with FANSI-CONSOLE, the more FANSI-CONSOLE _____________ FANSI-CONSOLE speeds up the screen writing. 1.2.3 Processes more ANSI X3.64 control sequences _____ _________ ____ ____ _____ _______ _________ 1.2.3 Processes more ANSI X3.64 control sequences FANSI-CONSOLE _____________ Another important feature is that FANSI-CONSOLE processes American National Standards Institute (ANSI) X3.64 standard control sequences (often called "escape sequences") like the standard IBM-PC DOS 2.00 (and later versions) ANSI.SYS device driver. A major purpose of FANSI-CONSOLE _____________ FANSI-CONSOLE is to provide a way for IBM-PCs and clones to meet FANSI-CONSOLE _ _____________ standards for government bidding. FANSI-CONSOLE allows you to use a ____ ______ ______ __ ___ _____ ________ much larger subset of the X3.64 standard than the standard IBM-PC FANSI- ______ ANSI.SYS device driver does. For more information about FANSI- CONSOLE _______ CONSOLE's conformance to standards, see the section entitled "What FANSI-CONSOLE _____________ standards does FANSI-CONSOLE support?", in the chapter entitled abbreviated ___________ "Using control sequences". Note that the abbreviated user manual found on the diskettes does not include this chapter but the complete printed user manual does. (C) Copyright 1984-86 Hersey Micro Consulting 1-4 (C) Copyright 1984-86 Hersey Micro Consulting 1-4 FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction All control sequences work in the graphics screen display modes as well as in the character screen display modes. This means programs can do more versatile things with the screen in a simpler and computer independent way. This is directly important to you because such programs can have their screen writing sent to remote terminals, or be redirected to data files. Indirectly, it is important to you, because it reduces program development costs. It does this by making it easier to write things to the screen. It also allows the same program to run without change on many different types of computers. Presumably, the program developers will pass the savings on to you. For more information about control sequences, see the chapter abbreviated ___________ entitled "Using control sequences". Note that the abbreviated user manual found on the diskettes does not include this chapter but the complete printed user manual does. The diskettes do have a few demonstration files on them, though. Using these control sequences, you can limit the screen writing of some programs to a portion of the screen called a "window" or a "scrolling region". You can scroll these windows in any direction or otherwise modify them without affecting characters on the rest of the screen. A program which knows about scrolling regions may use more than one scrolling region to effectively divide the screen. For more information about scrolling regions, see the description of the ANSI SSR command in the chapter entitled "ANSI X3.64 control sequences". abbreviated ___________ Note that the abbreviated user manual found on the diskettes does not include this chapter but the complete printed user manual does. The diskettes do have a few demonstration files on them, though. 1.2.4 Emulates DEC VT100 _____ ________ ___ _____ 1.2.4 Emulates DEC VT100 FANSI-CONSOLE _____________ FANSI-CONSOLE can make the numeric key pad and function keys emulate a DEC VT100 auxiliary key pad. With the processing of ANSI X3.64 control sequences, this can make the IBM-PC console look like a DEC VT100 to any application program. This is useful because there are already many good programs written for computers that use the VT100 for a console. The console handling of such programs do not have to be rewritten to allow them to run on an IBM-PC. It also means that simple terminal emulation (communications) programs which use MS-DOS MODEM86 (tm) _______ ____ console calls, such as our MODEM86 (tm) program, turns your IBM-PC or clone into an ANSI X3.64 standard terminal. For more information FANSI- ______ about VT100 emulation, see the section entitled "How do I get FANSI- CONSOLE _______ CONSOLE to emulate a VT100?" in the chapter entitled "Keyboard abbreviated ___________ Arrangement". Note that the abbreviated user manual found on the diskettes does not include this chapter but the complete printed user manual does. (C) Copyright 1984-86 Hersey Micro Consulting 1-5 (C) Copyright 1984-86 Hersey Micro Consulting 1-5 FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction FANSI-CONSOLE _____________ FANSI-CONSOLE can also emulate a DEC VT52/Heath H19/Zenith Z100 console as part of its VT100 emulation. For more information about getting into this mode, see the subsection describing the ANSI DEC-SM command in the chapter entitled "ANSI X3.64 control sequences". Note abbreviated ___________ that the abbreviated user manual found on the diskettes does not include this chapter but the complete printed user manual does. 1.2.5 Allows one finger pausing _____ ______ ___ ______ _______ 1.2.5 Allows one finger pausing FANSI-CONSOLE ______ ___ __ ___ __ ___ ___________ ___ ___ ________ _____________ FANSI-CONSOLE allows you to set up the Scroll-Lock key for optional ___ ______ _______ one finger pausing. You can set up the Scroll-Lock key to act as a scroll lock toggle. This is similar to the Ctrl-Num-Lock key combination you are already familiar with. However, it allows you to type ahead before turning off the scroll lock. With both the Ctrl- FANSI-CONSOLE _____________ Num-Lock and Scroll-Lock pausing, FANSI-CONSOLE prevents the duplicate lines which may appear when using the standard IBM-PC console software. For more information about one finger pausing, see the chapter entitled "Detailed Installation". 1.2.6 Allows more control over shifting and locking keys _____ ______ ____ _______ ____ ________ ___ _______ ____ 1.2.6 Allows more control over shifting and locking keys FANSI-CONSOLE _____________ FANSI-CONSOLE allows you to change the functioning of the shifting FANSI- ______ and locking keys. In addition to the handicap shift mode, FANSI- CONSOLE _______ CONSOLE allows you to change the shifting keys to stay shifted until you use their shifting effect, even if you take your fingers off the shift. It allows you to change the Caps-Lock to automatically unlock if you use a shift key. It allows you to change the Caps-Lock into a FANSI-CONSOLE _____________ "true" Caps-Lock, so that FANSI-CONSOLE ignores the shift keys when the Caps-Lock is on. It allows you to change the Caps-Lock into a Shift-Lock. 1.2.7 Allows recall of lines scrolled off the screen _____ ______ ______ __ _____ ________ ___ ___ ______ 1.2.7 Allows recall of lines scrolled off the screen FANSI-CONSOLE _____________ Another important optional feature of FANSI-CONSOLE is that when you pause with Scroll-Lock, it allows you to see lines which have already left the top of the screen. Such lines would otherwise be gone for good. Now you can even print them. We call this the scroll recall FANSI-CONSOLE _____________ feature. Unlike some scroll recall programs, FANSI-CONSOLE saves the lines in full color, and you can save them regardless of the current screen display mode. For more information about the scroll recall feature, see the chapter entitled "Detailed Installation" and the section entitled "How do I use the scroll recall feature?" in the abbreviated ___________ chapter entitled "Scroll Recall". Note that the abbreviated user manual found on the diskettes does not include this chapter but the complete printed user manual does. (C) Copyright 1984-86 Hersey Micro Consulting 1-6 (C) Copyright 1984-86 Hersey Micro Consulting 1-6 FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction You can reenter recalled lines as keyboard input. You can save recalled lines into a file. You can even print selected recalled lines. FANSI-CONSOLE _____________ FANSI-CONSOLE can now store scroll recall lines in either regular or FANSI-CONSOLE _____________ Expanded Memory. FANSI-CONSOLE works with any expanded memory manager which meets the Lotus Intel Microsoft (LIM) expanded memory specification. This includes all the expanded memory managers which also meet the AST expanded memory specification, since it is a superset of the LIM specification. 1.2.8 Allows much more type ahead _____ ______ ____ ____ ____ _____ 1.2.8 Allows much more type ahead Your keystrokes are called "type ahead" when the currently running FANSI-CONSOLE _____________ program is not reading them at the moment. FANSI-CONSOLE has a much larger type ahead buffer than the standard IBM-PC console software. Sometimes the program is busy with a previous command. Other times FANSI-CONSOLE _____________ the program just does not require keyboard input. FANSI-CONSOLE allows 255 characters of type ahead. The standard IBM-PC console software allows only 15 characters. This means you are much less likely to get that horrible beep that means your computer is ignoring your keystrokes because the currently running program is busy. The convenience of so much type ahead also brings problems of discovering FANSI-CONSOLE _____________ that you mistyped something early on. So FANSI-CONSOLE also allows _____ ___ ____ _____ ______ you to flush the type ahead buffer with a Ctrl-F without stopping the currently running program. Also Ctrl-C, Ctrl-Break, and Ctrl-S, all flush the type ahead buffer before their normal action. This means programs do not ignore you when you type these keys just because you happened to have typed ahead something else earlier. For more information about key usage, see the section entitled "How do I use FANSI-CONSOLE _____________ the FANSI-CONSOLE keyboard?". (C) Copyright 1984-86 Hersey Micro Consulting 1-7 (C) Copyright 1984-86 Hersey Micro Consulting 1-7 FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction 1.2.9 Allows keyboard macro assignment during running programs _____ ______ ________ _____ __________ ______ _______ ________ 1.2.9 Allows keyboard macro assignment during running programs FANSI-CONSOLE _____________ Like the standard IBM-PC ANSI.SYS device driver, FANSI-CONSOLE allows you to assign keyboard macros to keys. Unlike the standard IBM-PC FANSI-CONSOLE _____________ ANSI.SYS device driver, FANSI-CONSOLE allows you to do this even during a running program. A keyboard macro is a string of characters you assign to a particular key. By pressing that key, you can automatically input a whole string of characters. Using keyboard macros avoids the tedium of typing the same long string of characters FANSI-CONSOLE _____________ more than once. Unlike the standard IBM-PC ANSI.SYS, FANSI-CONSOLE allows you to specify whether to expand macros for all input, or for just MS-DOS input. For more information about keyboard macros, see FANSI-CONSOLE _____________ section entitled "How do I assign macros to FANSI-CONSOLE keys?" in the chapter entitled "Keyboard Arrangement". Note that the abbreviated ___________ abbreviated user manual found on the diskettes does not include this chapter but the complete printed user manual does. 1.2.10 Allows more memory for keyboard macros ______ ______ ____ ______ ___ ________ ______ 1.2.10 Allows more memory for keyboard macros FANSI-CONSOLE _____________ FANSI-CONSOLE allows more memory for keyboard macros than the standard IBM-PC ANSI.SYS device driver. It also allows you to specify how much memory to use for keyboard macros. For more information about memory usage, see the chapter entitled "Detailed Installation". 1.2.11 Turns displays off when not in use ______ _____ ________ ___ ____ ___ __ ___ 1.2.11 Turns displays off when not in use FANSI-CONSOLE _____________ For most display adapters, FANSI-CONSOLE can be configured to automatically turn off your console displays when not in use for a specified time. This prevents you from permanently burning a particular pattern into the phosphors on a screen by leaving it on FANSI-CONSOLE _____________ the screen too long. If you have two display adapters, FANSI-CONSOLE turns off both displays. Note that to avoid surprising you, this is not the default action. For more information about the screen save feature, see the chapter entitled "Detailed Installation". 1.2.12 Allows one finger typing ______ ______ ___ ______ ______ 1.2.12 Allows one finger typing FANSI-CONSOLE ______ ___ __ ___ __ ___ ________ ___ ________ ____ _____________ FANSI-CONSOLE allows you to set up the keyboard for optional one- ______ ______ finger typing for the physically handicapped. When combined with the one-finger pausing and scroll recall, the console becomes a much more convenient tool for the physically handicapped. For more information about one finger typing, see the chapter entitled "Detailed Installation". (C) Copyright 1984-86 Hersey Micro Consulting 1-8 (C) Copyright 1984-86 Hersey Micro Consulting 1-8 FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction 1.2.13 Allows keyboard generated breakpoints ______ ______ ________ _________ ___________ 1.2.13 Allows keyboard generated breakpoints FANSI-CONSOLE _____________ FANSI-CONSOLE has Alt-Ctrl-Ins set up to generate the equivalent of a breakpoint. This is handy for assembly language programmers, when debugging programs with infinite loops. For more information about keyboard generated breakpoints, see the subsection entitled "Using the Alt-Ctrl-Ins key" in the chapter entitled "Advanced Features". abbreviated ___________ Note that the abbreviated user manual found on the diskettes does not include this chapter but the complete printed user manual does. 1.2.14 Eliminates screen flicker ______ __________ ______ _______ 1.2.14 Eliminates screen flicker A feature that owners of most IBM-PC Color Graphics Adapter (CGA) FANSI-CONSOLE _________ _____________ clones, will love is that FANSI-CONSOLE can be used to eliminate _______ _______ flicker (blink) as it scrolls the screen. With some adapters, like FANSI-CONSOLE _____________ Tecmar's Graphics Master, FANSI-CONSOLE can do this in both software and hardware scrolling modes. With these same adapters, some TopView ___ compatible programs (when not running under TopView) can be made to write to the screen faster and not blink the screen even if they write to the screen memory directly. Unfortunately, with the standard IBM-PC Color Graphics Adapter, you can only use this when using quick hardware scrolling mode because of a hardware design deficiency __ (well, we call it that). To identify these adapters more easily when making purchasing decisions, we have included a program called SNOW. You can use SNOW to determine whether an adapter requires that annoying blinking during software scrolling. For more information about eliminating screen flicker, see the chapter entitled "Detailed Installation". 1.2.15 Provides support for displays with more rows and columns ______ ________ _______ ___ ________ ____ ____ ____ ___ _______ 1.2.15 Provides support for displays with more rows and columns For display adapters with enough display memory and appropriate CRT FANSI- ______ controller chip, and screens with a long persistence phosphor, FANSI- CONSOLE _______ CONSOLE supports several 50 line interlace screen display modes. Note that this support can not be used on the standard IBM-PC Monochrome Display and Printer Adapter, because it does not have enough screen memory. For Enhanced Graphics Adapters with Enhanced Graphics FANSI-CONSOLE _____________ Displays, FANSI-CONSOLE supports several 43 line screen display modes. For more information about 43 and 50 line screen display modes, see the subsection describing the FANSI-DBLROWS parameter for the FANSI-RM/FANSI-SM commands in the chapter entitled "Changing abbreviated ___________ Options at Run-time". Note that the abbreviated user manual found on the diskettes does not include this chapter but the complete printed user manual does. (C) Copyright 1984-86 Hersey Micro Consulting 1-9 (C) Copyright 1984-86 Hersey Micro Consulting 1-9 FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction 1.2.16 Extends the IBM-PC ROM BIOS ______ _______ ___ ______ ___ ____ 1.2.16 Extends the IBM-PC ROM BIOS FANSI-CONSOLE _____________ The part of FANSI-CONSOLE which replaces the ROM BIOS, has several additional capabilities. Among other things, it has additional capabilities which make your IBM-PC more like an IBM-PC AT (in versatility, if not in speed). For more information about ROM BIOS extensions, see the chapter entitled "ROM BIOS calls". Note that the abbreviated ___________ abbreviated user manual found on the diskettes does not include this chapter but the complete printed user manual does. 1.2.17 Provides some control over use of color ______ ________ ____ _______ ____ ___ __ _____ 1.2.17 Provides some control over use of color FANSI-CONSOLE _____________ FANSI-CONSOLE provides some control over the use of color by some programs. Many programs use white characters on a black background. FANSI-CONSOLE _____________ For some of these programs, FANSI-CONSOLE allows you to force a different color combination to be used instead. Also, if you have a monochrome screen attached to your color graphics adapter, some FANSI- ______ programs which use colors make your display hard to read. FANSI- CONSOLE _______ CONSOLE allows you to force some of these programs to use only black and white characters. For more information about color control, see the chapter entitled "Detailed Installation". 1.2.18 Provides control over key repeat rate ______ ________ _______ ____ ___ ______ ____ 1.2.18 Provides control over key repeat rate FANSI-CONSOLE _____________ FANSI-CONSOLE provides control over the keyboard key repeat rate. You can set the repeat rate faster for more zippy response to your arrow or paging keys, for example. You can set it slower, if you require it. You can shorten or lengthen the delay before the repeating starts. You can even turn off the repeating entirely. For more information about the keyboard repeat rate, see the chapter entitled abbreviated ___________ "Changing Options at Run-time". Note that the abbreviated user manual found on the diskettes does not include this chapter but the complete printed user manual does. (C) Copyright 1984-86 Hersey Micro Consulting 1-10 (C) Copyright 1984-86 Hersey Micro Consulting 1-10 FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction 1.2.19 Provides control over key clicks ______ ________ _______ ____ ___ ______ 1.2.19 Provides control over key clicks FANSI-CONSOLE _____________ FANSI-CONSOLE allows you to add a click to your keys. This is useful for those of you with silent clone keyboards. You can change the key click frequency and duration. You can select whether only the first key clicks or repeated keys click also. 1.2.20 Other features ______ _____ ________ 1.2.20 Other features FANSI-CONSOLE _____________ FANSI-CONSOLE will have other features which will become documented as they become ready for use. Your distribution diskettes have files on them which may briefly describe some new features added since we abbreviated ___________ printed this manual. This includes an abbreviated user manual and a history file briefly indicating recent changes. The abbreviated user manual is slightly more up to date than the printed user Manual. (C) Copyright 1984-86 Hersey Micro Consulting 1-11 (C) Copyright 1984-86 Hersey Micro Consulting 1-11 FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction 1.3 What about multitasking windowing programs and FANSI-CONSOLE? _____________ 1.3 What about multitasking windowing programs and FANSI-CONSOLE? FANSI-CONSOLE _____________ You may wonder how FANSI-CONSOLE compares with the new multitasking windowing programs such as IBM's TopView, Quarterdeck's DesqView, or FANSI-CONSOLE _____________ Microsoft's Windows. FANSI-CONSOLE is not meant to compete directly with these programs. Such programs are called "multitasking" because they allow several programs to be in the middle of doing their respective "tasks" at the same time. A multitasking windowing program manages the screen for such tasks, and allows you to switch between FANSI-CONSOLE _____________ tasks. We want to make it clear that FANSI-CONSOLE does not handle FANSI-CONSOLE _____________ multitasking. You can use FANSI-CONSOLE with most multitasking FANSI-CONSOLE _____________ windowing programs. FANSI-CONSOLE may not affect them or the programs running under them, since most of these multitasking windowing programs write directly to the screen hardware. There are times, though, when you want to run without the multitasking windowing program, to do things like run batch files or programs with command FANSI-CONSOLE _____________ line parameters. At these times, FANSI-CONSOLE speeds up the screen writing. FANSI-CONSOLE _____________ We believe that FANSI-CONSOLE is generally a more helpful product for the budget minded customer than multitasking windowing programs. FANSI-CONSOLE _____________ FANSI-CONSOLE offers much less in the way of features than most FANSI-CONSOLE _____________ multitasking windowing programs, but FANSI-CONSOLE uses much less read/write memory and no secondary memory like additional disks, and costs less than most multitasking windowing programs. Multitasking windowing programs usually need much more than 256 KB of read/write memory and a fixed disk for quick execution or sometimes any execution! These programs generally use all this memory to keep several programs in memory at once, as well as copies of their screen displays. Requiring that much memory or fixed disks means that those of you who cannot afford to lay out so much money per workstation can not use multitasking windowing programs. Even if you can afford a multitasking windowing program and its FANSI-CONSOLE _____________ required extra hardware, you may find FANSI-CONSOLE more to your FANSI-CONSOLE _____________ liking. FANSI-CONSOLE speeds up the screen writing of many programs to make them quick enough for your tastes. When your favorite FANSI-CONSOLE _____________ application program still takes awhile to do something, FANSI-CONSOLE allows you to keep typing by having a generous type ahead buffer. Most multitasking windowing products do nothing to speed up the screen writing of other programs. They also do not allow you to type ahead much. Many slow things down, even though they claim to be "user-friendly". However, it is generally recognized that being speedy is the most user-friendly quality of a product. (C) Copyright 1984-86 Hersey Micro Consulting 1-12 (C) Copyright 1984-86 Hersey Micro Consulting 1-12 FANSI-CONSOLE Introduction _____________ FANSI-CONSOLE Introduction FANSI-CONSOLE _____________ Another reason to like FANSI-CONSOLE is that once you install it, it ___ does not require separate installation of the programs you run with FANSI-CONSOLE _____________ FANSI-CONSOLE. Most multitasking windowing programs require a sometimes laborious installation process for each program you intend to run with the multitasking windowing program. (C) Copyright 1984-86 Hersey Micro Consulting 1-13 (C) Copyright 1984-86 Hersey Micro Consulting 1-13 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly Chapter 2 Chapter 2 Starting Quickly Starting Quickly 2.1 Do I have to read the whole FANSI-CONSOLE user manual? _____________ 2.1 Do I have to read the whole FANSI-CONSOLE user manual? 2.1.1 NO! 2.1.1 NO! ___ You do not have to read this whole manual from cover to cover to take FANSI-CONSOLE _____________ advantage of FANSI-CONSOLE. You only have to know the information in ______ this chapter to get started. If you want really brief instructions, ____ just read the description of this chapter in the table of contents! It really tells you what to do! We know how much you hate to have to read the manual before trying out a program. Unfortunately, this program can not be menu driven because of its nature. We have an extensive index at the end of this manual to help you when you have problems finding what you want to know. We also have a glossary at the end of this manual to help you find the meaning of technical terms and abbreviations. Please use them, especially if you do not read the manual from cover to cover. For example, you can find solutions to many common problems by looking up the keyword "problem" in the index. If you can not find something where you first looked in the index, let us know! We think the index should be comprehensive. That minimizes the number of calls we get asking about things the manual fully explains but you can not find. - The chapter entitled "Compatibilities and Limitations" describes FANSI-CONSOLE _____________ how to solving compatibility problems with FANSI-CONSOLE. You should read that if you experience problems. If you can not find what you want to know in the abbreviated user manual found on the distribution diskettes, then it is probably time to order a complete printed user manual. You can tell this when you find yourself looking for a page number mentioned in the index or table of contents which abbreviated user manual does not include. The index and the table of contents are complete, but the rest of the ___ abbreviated user manual is not! The abbreviated user manual is only FANSI-CONSOLE _____________ complete enough to install FANSI-CONSOLE and test it for compatibility with your hardware and software. It should convince you FANSI-CONSOLE _____________ that FANSI-CONSOLE really is faster and professional and that you really need the complete printed manual! (C) Copyright 1984-86 Hersey Micro Consulting 2-1 (C) Copyright 1984-86 Hersey Micro Consulting 2-1 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly FANSI-CONSOLE _____________ Lastly, even though you can use FANSI-CONSOLE without reading the chapter on its distribution, please read it, too. It has important information about what we expect in return from you for your being FANSI-CONSOLE _____________ able to use FANSI-CONSOLE. (C) Copyright 1984-86 Hersey Micro Consulting 2-2 (C) Copyright 1984-86 Hersey Micro Consulting 2-2 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly 2.2 How do I quickly install FANSI-CONSOLE? _____________ 2.2 How do I quickly install FANSI-CONSOLE? FANSI- ______ The following is the simplest possible setup procedure for FANSI- CONSOLE FANSI-CONSOLE _______ _____________ CONSOLE. Use it if you are in a hurry to try FANSI-CONSOLE. Keep in FANSI-CONSOLE _____________ mind that FANSI-CONSOLE has many features, including quicker blink ___ free scrolling, which can not be taken advantage of without more detailed installation. Further reading will allow you to take advantage of those features at a later time. If you have an IBM-PC clone or if you have non-IBM display adapter, you may need to do the FANSI-CONSOLE _____________ detailed installation to get the full functionality of FANSI-CONSOLE. FANSI-CONSOLE _____________ You need to do this to tell FANSI-CONSOLE that your computer is different, no matter how equivalent you may believe it is. The chapter entitled "Detailed Installation" describes these options. 2.2.1 Verify distribution diskettes _____ ______ ____________ _________ 2.2.1 Verify distribution diskettes The first step is to verify that the distribution diskettes have at least the following files. Note that we "squeezed" some of these files to make them take up less room on the distribution diskettes. If we squeezed them, then we replaced the middle letter of the extension with a "Q". You must use UNSQZ.COM to unsqueeze any files we squeezed. README.NOW abbreviated ___________ README.NOW Short directions for printing the abbreviated user manual. ANSI80.TXT ANSI80.TXT Test data for 80 column screen displays. Chock full of examples of ANSI X3.64 control sequences. TYPE it for a demo! AT.LAY AT.LAY AT keyboard layout file. Also appropriate for the Data General One and Tandy 1000. For use with FLAYOUT. CHARSETS.TXT CHARSETS.TXT A file which demonstrates how to generate the entire the IBM-PC character set using appropriate designations and shifts. TYPE it for a demo! DEJAVU.EXE DEJAVU.EXE Program which writes the lines from the scroll recall buffer to a file. DIZZY.C DIZZY.C This is the source for C program which generated part of ANSI80.TXT. (C) Copyright 1984-86 Hersey Micro Consulting 2-3 (C) Copyright 1984-86 Hersey Micro Consulting 2-3 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly DVORAK.TXT DVORAK.TXT Test data to set up a quasi-Dvorak keyboard layout. Unless you know what a Dvorak keyboard layout is, we NOT ___ strongly suggest that you NOT TYPE this file. This is not a real Dvorak layout, but only an example of key redefinition. See the chapter entitled "Keyboard Arrangement" to find out how to get a real Dvorak abbreviated ___________ layout. Note that the abbreviated user manual does not include this chapter but the complete printed user manual does. EGALGCHR.COM EGALGCHR.COM Decreases the number of lines of characters on the EGA, by using a larger character cell size. The actual number of lines is either 25 or 14 depending on the screen FANSI- ______ display mode. You may use this with or without FANSI- CONSOLE _______ CONSOLE. EGASMCHR.COM EGASMCHR.COM Increases the number of lines of characters on the EGA, by using a smaller character cell size. The actual number of lines is either 43 or 25 depending on the screen display mode. You may use this with or without FANSI-CONSOLE _____________ FANSI-CONSOLE. EXPAND.COM EXPAND.COM Expands tab characters into spaces. Useful if your printer does not process the tab characters in FCONSOLE.DOC correctly. FANSICAP.TXT FANSICAP.TXT FANSI-CONSOLE _____________ Annotated Unix termcap file for FANSI-CONSOLE when FANSI-VT100 is reset. It works with communications programs that interface with the console through BIOS or FANSI-CONSOLE _____________ MS-DOS calls. You can use FANSI-CONSOLE with Visual editors such as 'vi' and 'emacs' with this termcap. FANSISET.EXE FANSISET.EXE FANSI-CONSOLE _____________ Menu driven program for changing FANSI-CONSOLE options at run-time. FANSISET.TXT FANSISET.TXT FANSI-CONSOLE _____________ Example FANSI-CONSOLE setup file. TYPE this file to speed up the key repeat rate. FCONBBS.LST FCONBBS.LST List of Bulletin Board Systems (BBS) which may keep up FANSI-CONSOLE _____________ to date downloadable versions of FANSI-CONSOLE. FCONBETA.DEV FCONBETA.DEV FANSI-CONSOLE _____________ "Beta test" version of FANSI-CONSOLE. Usually, we tested this version less than the commercial version. It may have more programming errors, but it may also have newer features you may want to try. Sometimes it is a previous FANSI-CONSOLE _____________ commercial version of FANSI-CONSOLE. (C) Copyright 1984-86 Hersey Micro Consulting 2-4 (C) Copyright 1984-86 Hersey Micro Consulting 2-4 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly FCONSOLE.BQO FCONSOLE.BQO You must UNSQZ this file into FCONSOLE.BRO. FCONSOLE.BRO FANSI-CONSOLE _____________ is the FANSI-CONSOLE brochure file. This is a brief FANSI-CONSOLE _____________ description of what FANSI-CONSOLE can do. It is the same text as found in our printed brochures. FCONSOLE.DEV FCONSOLE.DEV FANSI-CONSOLE _____________ FANSI-CONSOLE itself. This is the commercial version. It is more stable and error free than FCONBETA.DEV. The current printed manual describes this version. FCONSOLE.DQC FCONSOLE.DQC You must UNSQZ this file into FCONSOLE.DOC. FCONSOLE.DOC FANSI-CONSOLE abbreviated _____________ ___________ is the FANSI-CONSOLE abbreviated user manual for beta test version. This file may include information about FANSI-CONSOLE _____________ the beta test version of FANSI-CONSOLE which the printed user manual does not include yet. PRINT or TYPE it. You are reading a copy of it now! FCONSOLE.HST FCONSOLE.HST Revision history information. This file may include FANSI-CONSOLE _____________ information about the latest version of FANSI-CONSOLE which the printed user manual does not include yet. PRINT or TYPE this file. FLAYOUT.EXE FLAYOUT.EXE Program to rearrange your keyboard keys to your liking. RAWMODE.MAC RAWMODE.MAC Source for subroutines useful for programmers wishing to speed up their program's screen writing. See the comments in the file for information about on usage. SEND.EXE SEND.EXE Useful for sending control sequences to the console or printer. See the chapter entitled "Using Control Sequences" for information about usage. Note that the abbreviated ___________ abbreviated user manual does not include this chapter but the complete printed user manual does. SNOW.COM FANSI- ______ SNOW.COM Test program to help you decide how to set some FANSI- CONSOLE _______ CONSOLE hardware options. Simply run the program. See the chapter entitled "Detailed Installation" for information about usage. SPIT.EXE SPIT.EXE Test program for slowly trying test data. Use it to display a file on the console, like the MS-DOS TYPE command. It waits, with no prompts, for you to press a key between every line displayed. STANDARD.LAY STANDARD.LAY Standard keyboard layout file. For use with FLAYOUT. (C) Copyright 1984-86 Hersey Micro Consulting 2-5 (C) Copyright 1984-86 Hersey Micro Consulting 2-5 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly TRAP.COM TRAP.COM Program to trap INT calls for problem reporting purposes. For more information, see the subsection entitled "How to use TRAP" in the chapter entitled "Compatibility and Limitations". UNSQZ.COM UNSQZ.COM Program to unsqueeze files. For example, UNSQZ FCONSOLE.DQC produces FCONSOLE.DOC. WATZITBE.COM WATZITBE.COM Displays the scan codes for each key pressed. Useful for reporting information to us about nonstandard keyboards. For more information, see the subsection entitled "How to use WATZITBE and WATZITDO" in the chapter entitled "Compatibility and Limitations". WATZITDO.COM WATZITDO.COM Displays the effects of pressing keys. Useful for reporting information to us about nonstandard keyboards. For more information, see the subsection entitled "How to use WATZITBE and WATZITDO" in the chapter entitled "Compatibility and Limitations". WORDSTAR.PCH WORDSTAR.PCH You must UNSQZ this file into WORDSTAR.PCH. Patch for WordStar 3.3 to make it write to the screen faster. See the comments in the file for information about usage. It not ___ is not necessary to use this patch to use WordStar with FANSI-CONSOLE _____________ FANSI-CONSOLE. If the distribution diskettes do not have all the listed files, ask whomever you got the program from to give you the missing files. They are supposed to give you all the files listed here. The distribution diskettes may have additional optional files. Please note that the user manual which appears on these diskettes is abbreviated ___________ abbreviated. We omitted chapters describing advanced features in abbreviated ___________ detail from the abbreviated user manual on the diskettes. See the chapter entitled Distribution and Licensing. (C) Copyright 1984-86 Hersey Micro Consulting 2-6 (C) Copyright 1984-86 Hersey Micro Consulting 2-6 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly 2.2.2 Backup distribution diskettes _____ ______ ____________ _________ 2.2.2 Backup distribution diskettes The second step is to make a backup copy of your distribution diskettes using the MS-DOS DISKCOPY command, as outlined in the MS- DOS manual. Start out by making sure you write protect the distribution diskettes, so you do not accidentally destroy the __ ____ contents of a diskette by copying to it instead of copying from it. After all, the reason you should make the backup copy in the first place is to have extra copies if one copy gets accidentally destroyed. 2.2.3 Backup system disks _____ ______ ______ _____ 2.2.3 Backup system disks The third step is to make backup copies of your MS-DOS 2.00 (or later versions) system diskettes using the MS-DOS DISKCOPY command, as outlined in the MS-DOS manual. A system disk is any disk with the MS- ___ DOS operating system on it. Many MS-DOS diskettes are NOT system disks. The best way to tell if a diskette is a system disk is to put the diskette into drive A: and restart MS-DOS by pressing Alt-Ctrl- Del. If MS-DOS starts without further changing diskettes, then the diskette is a system disk. If you have a fixed disk and you can start MS-DOS using Alt-Ctrl-Del without a diskette in drive A:, then your fixed disk is also a system disk. However, it is not necessary to FANSI-CONSOLE _____________ make a backup copy of your fixed disk just to try FANSI-CONSOLE. If your MS-DOS version is less than 2.00, then run out and buy the FANSI-CONSOLE _____________ latest version now! FANSI-CONSOLE requires at least version 2.00. Many other programs soon will as well. Do not get lost in the past! (C) Copyright 1984-86 Hersey Micro Consulting 2-7 (C) Copyright 1984-86 Hersey Micro Consulting 2-7 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly 2.2.4 Copy FCONSOLE.DEV to system disk _____ ____ ____________ __ ______ ____ 2.2.4 Copy FCONSOLE.DEV to system disk The fourth step is to copy the file FCONSOLE.DEV from our distribution diskette to your MS-DOS 2.00 (or later) system disks using the MS-DOS COPY command. Copy FCONSOLE.DEV to the root directory on the system disk. Do this to all your system disks, if you have more than one. However, we suggest that you do them one at a time. Test each one for a few days, or a time period comfortable for you, before installing it on other system disks. If you have a fixed disk, we suggest you try this on a diskette first before installing FANSI-CONSOLE _____________ FANSI-CONSOLE on the fixed disk. All this caution merely allows you FANSI-CONSOLE _____________ to start MS-DOS without FANSI-CONSOLE if you have some problems with it on your computer. If you are a bit adventurous, you might want to try FCONBETA.DEV FANSI- ______ instead of FCONSOLE.DEV. It is our latest beta test version of FANSI- CONSOLE _______ CONSOLE. It may have new features as documented in the FCONSOLE.HST file. However, it may contain programming errors. So try it at your own risk. We do not promise to fix programming errors which may appear in the beta test version. 2.2.5 Add DEVICE=FCONSOLE.DEV to CONFIG.SYS _____ ___ ___________________ __ __________ 2.2.5 Add DEVICE=FCONSOLE.DEV to CONFIG.SYS The fifth step is to add the line: DEVICE=FCONSOLE.DEV DEVICE=FCONSOLE.DEV to the beginning of the file named CONFIG.SYS in the root directory on your system disk. You may use either upper or lower case letters. You may use your favorite editor to do this. If the root directory on your system disk has no file named CONFIG.SYS, you must create one. When you start MS-DOS, if the root directory on your system disk has a file named CONFIG.SYS, MS-DOS reads it for special instructions. The file cannot have a different name, or MS-DOS will not read it when it starts. The line that you add to the CONFIG.SYS file is a FANSI-CONSOLE _____________ special instruction to MS-DOS to install FANSI-CONSOLE when MS-DOS starts. It is important that the line be at the start of the CONFIG.SYS file instead of the middle or the end. This is mostly FANSI-CONSOLE _____________ because the sooner FANSI-CONSOLE gets loaded and displays its name banner, the sooner you may use your larger type ahead buffer. It is FANSI-CONSOLE _____________ also important that FANSI-CONSOLE be loaded before any other device drivers that require keyboard or screen handling, such as mouse device drivers. Otherwise, the position of this line does not usually FANSI- ______ matter. However, some device drivers must be loaded before FANSI- CONSOLE _______ CONSOLE. Check the chapter entitled "Compatibility and Limitations" to see if it has any special instructions for your device drivers. (C) Copyright 1984-86 Hersey Micro Consulting 2-8 (C) Copyright 1984-86 Hersey Micro Consulting 2-8 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly It is important that the "DEVICE=FCONSOLE.DEV" line ends with a carriage return, and not just with the end of the CONFIG.SYS file. _______ MS-DOS 2.0 has a programming error which causes such a line without the carriage return to yield the following strange looking message: Bad or missing FCONSOLE.DEVLE.DEV Bad or missing FCONSOLE.DEVLE.DEV The message really has the repeated part of the name in it. MS-DOS versions 3.0 and later do not have this error. If you have an IBM-PC clone or if you have non-IBM display adapter, you may also need to add some options to this line to get the full FANSI-CONSOLE FANSI- _____________ ______ functionality of FANSI-CONSOLE. You need to do this to tell FANSI- CONSOLE _______ CONSOLE that your computer is different, no matter how equivalent you may believe it is. The chapter entitled "Detailed Installation" describes these options. 2.2.6 Remove DEVICE=ANSI.SYS from CONFIG.SYS _____ ______ _______________ ____ __________ 2.2.6 Remove DEVICE=ANSI.SYS from CONFIG.SYS The sixth step is to delete any lines like: DEVICE=ANSI.SYS DEVICE=ANSI.SYS from the old CONFIG.SYS file. If you previously had a line like this for loading another console driver, such as the IBM-PC ANSI.SYS device driver, in the CONFIG.SYS file then you should now remove it. FANSI-CONSOLE _____________ This is because FANSI-CONSOLE is a replacement for ANSI.SYS as well as the part of the standard IBM-PC ROM BIOS that deals with the console. They both have the name "CON:" when used later with other MS-DOS commands. There is usually no point in trying to make them FANSI-CONSOLE _____________ coexist. FANSI-CONSOLE has all the function of the ANSI.SYS device driver and more. Please note that usually only other console drivers do not work with FANSI-CONSOLE _____________ FANSI-CONSOLE. You can use device drivers for devices other than the FANSI-CONSOLE _____________ console (CON:) with FANSI-CONSOLE. Such drivers include read/write FANSI-RAMDISK (tm) _____________ ____ memory-based diskette emulators (RAM disk) like FANSI-RAMDISK (tm) and mouse device drivers. So most lines which start with: DEVICE= DEVICE= do not need to be deleted from CONFIG.SYS. (C) Copyright 1984-86 Hersey Micro Consulting 2-9 (C) Copyright 1984-86 Hersey Micro Consulting 2-9 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly If you happen to load both console drivers, the one MS-DOS loads last is the one it really uses as the console driver. It has either of two bad effects, depending upon which driver you load first in CONFIG.SYS. If you load ANSI.SYS first, ANSI.SYS consumes memory to FANSI-CONSOLE _____________ no effect, since MS-DOS uses FANSI-CONSOLE instead of ANSI.SYS. If FANSI-CONSOLE _____________ you load FANSI-CONSOLE first, MS-DOS does not use the console driver FANSI-CONSOLE _____________ part of FANSI-CONSOLE. Instead it uses ANSI.SYS as the console FANSI-CONSOLE _____________ driver. However, the BIOS calls now call FANSI-CONSOLE. 2.2.7 Leave enough memory for applications programs _____ _____ ______ ______ ___ ____________ ________ 2.2.7 Leave enough memory for applications programs FANSI-CONSOLE _____________ Although, FANSI-CONSOLE does not require much memory for itself, it does require some. If you have made ram-disks or print spoolers consume all the extra memory you had before, then you need to adjust these programs to use a bit less. You need to have about the same amount of memory left over for applications programs as you did before. Otherwise programs run out of room because you have left too little for them. Many times not having enough memory causes either FANSI-CONSOLE FANSI- _____________ ______ FANSI-CONSOLE or some other resident program loaded after FANSI- CONSOLE _______ CONSOLE to hang during startup. Sometimes a program does not complain directly about having less memory, instead it starts doing more file accesses than before, for example. It may do this either to load and reload overlays or to spill large amounts of data into and out of a temporary file. This even happens on computers fully loaded with memory. Remember, the total memory you have does not count, only how much of it you have left for the applications programs. To determine the amount of memory left over for applications programs, use the MS-DOS CHKDSK command. The last line printed shows the amount of memory left over after installing all the resident programs. This is the amount usable by applications programs. We can not tell you exactly how much your application programs need, since it depends on what application programs you run. However, nearly everyone should leave at least 128 KB. FANSI-CONSOLE _____________ For more information about the memory requirements of FANSI-CONSOLE, FANSI-CONSOLE _____________ see the section entitled "How much memory does FANSI-CONSOLE require?" in the chapter entitled "Detailed Installation". (C) Copyright 1984-86 Hersey Micro Consulting 2-10 (C) Copyright 1984-86 Hersey Micro Consulting 2-10 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly 2.2.8 Restart MS-DOS _____ _______ ______ 2.2.8 Restart MS-DOS _______ ______ The seventh and last step is to restart MS-DOS. Now that you have changed your CONFIG.SYS file, all you do is use that system disk when you turn on the computer or when you press the Alt-Ctrl-Del key combination. Of course, you could have several system disks with both FCONSOLE.DEV and CONFIG.SYS on it. Any one of them will do. You do ___ not need to have these files on a disk which is on line after MS-DOS FANSI-CONSOLE _____________ is loaded at the start. FANSI-CONSOLE remains loaded in memory as part of the MS-DOS until the next time you restart MS-DOS. FANSI-CONSOLE _____________ You can tell that you correctly installed FANSI-CONSOLE when you see the single line banner with the program name and our copyright message at the top of your screen when you start. If you do not see FANSI- ______ the banner when you start, then you did not correctly install FANSI- CONSOLE _______ CONSOLE. It is as simple as that! In either case, the old familiar MS-DOS prompt appears after it completes your AUTOEXEC.BAT file. Notice that we do not beat you over the head with a full screen request for payment of the usage royalty, like some programs do. We just do that in the user manual! (C) Copyright 1984-86 Hersey Micro Consulting 2-11 (C) Copyright 1984-86 Hersey Micro Consulting 2-11 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly 2.2.9 Add BUFFERS=20 to CONFIG.SYS _____ ___ __________ __ __________ 2.2.9 Add BUFFERS=20 to CONFIG.SYS Although it is not usually necessary, you may also want to add something like the following line to the CONFIG.SYS file on your system disk: BUFFERS=20 BUFFERS=20 You may use either upper or lower case letters. The position of this in the CONFIG.SYS file does not matter. The purpose of this command is to allow more buffer space for MS-DOS to use for reading and FANSI-CONSOLE _____________ writing files. Although this has nothing to do with FANSI-CONSOLE, it also speeds up your computer by speeding up your file accesses. We mention it here because many people are unaware of it. The only negative aspect to using this line in your CONFIG.SYS file is that it consumes about 10 KB of read/write memory for extra buffer space which becomes unusable by your application programs. This is about 1/2 KB per buffer specified. However, you may replace the number 20 with a smaller number, even one as small as 5. It still speeds up your file accesses, although not as much. The space required is proportional to the number used. Using a larger number may help more if you have a large or full fixed disk. If the number is too large, it starts slowing the computer down again. Only you can find the best number for your computer, but almost any number is better than the 2 you get by default. FANSI-CONSOLE _____________ Sometimes, after installing FANSI-CONSOLE, the MS-DOS FORMAT command refuses to format disks. A programming error in the FORMAT command causes this problem. The error causes FORMAT to be sensitive to where MS-DOS loads it in memory. Particular FORMAT buffers must not cross 64 KB byte boundaries. FORMAT does not insure that it arranges them that way. So you must do the arranging yourself. If this error causes you a problem, the easiest solution is to slightly increase the number in the BUFFERS command and then restart MS-DOS. If you are already using the BUFFERS limit of 99, then slightly decrease the number. Keep changing the number in the same direction until FORMAT works correctly. (C) Copyright 1984-86 Hersey Micro Consulting 2-12 (C) Copyright 1984-86 Hersey Micro Consulting 2-12 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly 2.2.10 Modify Prompt ______ ______ ______ 2.2.10 Modify Prompt Although it is not necessary, you may want to add something like the following line to the file named AUTOEXEC.BAT on your system disk: PROMPT $e\$e[2;37;40m$e[J$n$g PROMPT $e\$e[2;37;40m$e[J$n$g Note that upper and lower case letters must be used exactly as indicated in the prompt. Also, if you use any extra spaces here, you get extra spaces in your MS-DOS prompt. This is a MS-DOS internal command that describes the prompt that MS-DOS uses when it is ready for a new command. If the root directory on your system disk has no file named AUTOEXEC.BAT, you must create one. When you start MS-DOS, if the root directory on your system disk has a file named AUTOEXEC.BAT, MS-DOS reads it for commands to do as it starts. The file cannot have a different name, or MS-DOS will not read it when it starts. The line that you add to the AUTOEXEC.BAT file is a command to MS-DOS that tells it how to do a prompt. It is not important where you add the line to the AUTOEXEC.BAT file. Note that MS-DOS does not display the control sequences in a PROMPT command. Instead, it performs the actions of the control sequences. In this example, we have it send out an ANSI X3.64 SGR control sequence (indicated by the "$e[2;37;40m") to set the current screen colors and other attributes to the normal values (low intensity white foreground on a black background) before displaying the current drive letter ($n) and a greater than symbol ($g). We also send out an ANSI X3.64 erase in display control sequence ($e[J) to erase the rest of the screen in the current colors (again low intensity white foreground on a black background). We recommend this because some programs leave the current screen color attributes in undesired states. If you do not erase the screen, even though what you type is the right color, and the rest of the screen is black, the cursor may be a different color. The "$e\" is a string terminator sequence. It terminates any control sequence string an aborted program may have left unfinished. You may consider a different set of colors or attributes desirable. You may also want the MS-DOS prompt to use different colors or have different attributes than what you type after it. So you may want to use different ANSI X3.64 SGR commands, like the following: PROMPT $e\$e[2;32;40m$e[J$e[1;36m$n$g$e[2;32m PROMPT $e\$e[2;32;40m$e[J$e[1;36m$n$g$e[2;32m (C) Copyright 1984-86 Hersey Micro Consulting 2-13 (C) Copyright 1984-86 Hersey Micro Consulting 2-13 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly This prompt erases the screen with a green foreground on a black background, displays the current drive and a greater than symbol in a cyan foreground on a black background, and insures that command characters you type appear with a green foreground on a black background. You can create a more elaborate prompt of your own choosing by using more complicated ANSI X3.64 control sequences (described in the chapter entitled "ANSI X3.64 Control Sequences" not ___ which the abbreviated user manual does not include) and other PROMPT command options. However, using a prompt like this does have some small side effects, which you should note. 1. The PROMPT only resets the foreground and background colors after every MS-DOS command, when the MS-DOS ECHO is ON. If ECHO is OFF, it has no effect. 2. The PROMPT resets the foreground and background colors after _____ every MS-DOS command, when the MS-DOS ECHO is on. This means that you can not change the colors without changing the PROMPT, since it resets them again immediately afterwards. So you may ______ want to experiment with different colors before setting up this PROMPT. 3. MS-DOS apparently counts the prompt characters, except the escape. When you use this prompt and you type the line-delete character (ESC for PC-DOS and Ctrl-X for MS-DOS) to restart a line that you type at the MS-DOS prompt, MS-DOS spaces over too far for the new line. It does not realize that some of these prompt characters do not really appear on the screen. 4. When you use this prompt and you type the echo-console-onto- printer character (Ctrl-PrtSc for PC-DOS and Ctrl-P for MS- DOS), prompts do not appear the same as they do on the screen. This is because your printer does not understand ANSI X3.64 control sequences. 5. When you include an erase in display command as part of your prompt, there is a small delay during the erasing before the printed part of your prompt appears. The closer the prompt is to the top of the display, the longer the delay. This is more noticeable with some display adapters (those requiring the /H=1 option) than others. 6. You may run out of MS-DOS environment space if you make your prompt too long. If you use MS-DOS 3.10, you can add /E:n to the CONFIG.SYS SHELL command parameters to the COMMAND.COM program to enlarge your environment space to ((n+1)*16) bytes. The position of this line in the CONFIG.SYS file does not matter. An example SHELL command would be SHELL=\COMMAND.COM /E:20 /P "SHELL=\COMMAND.COM /E:20 /P". (C) Copyright 1984-86 Hersey Micro Consulting 2-14 (C) Copyright 1984-86 Hersey Micro Consulting 2-14 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly 2.2.11 Add TYPE FANSISET.TXT to AUTOEXEC.BAT ______ ___ ____ ____________ __ ____________ 2.2.11 Add TYPE FANSISET.TXT to AUTOEXEC.BAT Although it is not necessary, you may want to add something like the following line to the file named AUTOEXEC.BAT on your system disk: TYPE FANSISET.TXT TYPE FANSISET.TXT The FANSISET.TXT file on the distribution diskettes contains control sequences which decrease the key repeat delay and speed up the key repeat rate. You may want to add other control sequences to this file. Unlike the control sequences produced by the PROMPT command, these should be control sequences you normally only want done once when you start up. Note that the TYPE command does not display the control sequences in a file. Instead, it performs the actions of the control sequences. For more information about these and other control sequences which you may want to use in FANSISET.TXT, see the chapter entitled "ANSI abbreviated ___________ X3.64 control sequences". Note that the abbreviated user manual does not include this chapter but the complete printed user manual does. The diskettes do have a few demonstration files on them, though. Some MS-DOS manuals also describe the ones which ANSI.SYS processes. (C) Copyright 1984-86 Hersey Micro Consulting 2-15 (C) Copyright 1984-86 Hersey Micro Consulting 2-15 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly 2.3 How do I use FANSI-CONSOLE? _____________ 2.3 How do I use FANSI-CONSOLE? FANSI-CONSOLE _____________ Now that you have FANSI-CONSOLE installed, you just proceed as you FANSI-CONSOLE _____________ always do, and mostly ignore that FANSI-CONSOLE is loaded and FANSI-CONSOLE _____________ running. When the FANSI-CONSOLE banner appears at the top of your screen when you start MS-DOS, many programs magically write to the screen faster without your further intervention. All you must do now is appreciate our efforts! As noted before, you may want to use the type ahead buffer more than before. You may also want to take advantage of the new special keys described here. Later chapters describe some more useful features, but you do not need to rush to those chapters yet. 2.3.1 Using the Ctrl-F key 2.3.1 Using the Ctrl-F key Press the Ctrl-F key to simply flush (empty) the type ahead buffer. The Ctrl-F is left in the buffer, but many programs ignore it or do something harmless. If you have an application that does something dangerous with the Ctrl-F key, you may want to try the Ctrl-S key instead. 2.3.2 Using the Ctrl-S key 2.3.2 Using the Ctrl-S key Press the Ctrl-S key to flush the type ahead buffer and, if the current program uses Ctrl-S as a pause key, cause the current program to pause. Most programs pay attention to this key and pause. Otherwise they probably ignore it. The standard IBM-PC console software processes the Ctrl-S slightly differently, by not flushing the type ahead buffer when you press a Ctrl-S. This means that the standard IBM-PC console software ignores the Ctrl-S character if you already have some characters in the type ahead buffer. For other ways to pause, see the description of the Ctrl-Num-Lock key in the next paragraph and of the /L option in the chapter entitled "Detailed Installation". (C) Copyright 1984-86 Hersey Micro Consulting 2-16 (C) Copyright 1984-86 Hersey Micro Consulting 2-16 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly 2.3.3 Using the Ctrl-Num-Lock key 2.3.3 Using the Ctrl-Num-Lock key Press the Ctrl-Num-Lock key to cause the display to pause without FANSI-CONSOLE _____________ flushing the type ahead buffer. With FANSI-CONSOLE this key combination works in a manner similar to the way it works with the standard IBM-PC console software. One advantage, however, is that FANSI-CONSOLE _____________ unlike the standard IBM-PC console software, FANSI-CONSOLE prevents the appearance of duplicate lines during a pause. Press any other key combination to unlock the pause. Unless the second key combination is FANSI-CONSOLE _____________ a Ctrl-Break or a Ctrl-C, FANSI-CONSOLE ignores it other than for FANSI-CONSOLE _____________ clearing the pause. Any program that works with FANSI-CONSOLE pauses with Ctrl-Num-Lock. For other ways to pause, see the description of the Ctrl-S in the previous paragraph and of the /L option in the chapter entitled "Detailed Installation". 2.3.4 Using the Ctrl-C or Ctrl-Break keys 2.3.4 Using the Ctrl-C or Ctrl-Break keys FANSI-CONSOLE _____________ Press the Ctrl-C key to cancel most programs. FANSI-CONSOLE treats it the same way as the Ctrl-Break key for programs using MS-DOS input. It treats both keys the same way that the standard IBM-PC console software treats the Ctrl-Break key. It flushes the type ahead buffer before placing a Ctrl-C in it. The standard IBM-PC console software processes the Ctrl-C slightly differently, by not flushing the type ahead buffer when you press a Ctrl-C. This means that the standard IBM-PC console software ignores the standard MS-DOS Ctrl-C cancel character when you already have some characters in the type ahead buffer. Pressing Ctrl-C does not cancel any program that Ctrl-Break does not cancel when using the standard IBM-PC console software. 2.3.5 Using the Alt-Ctrl-Grave key 2.3.5 Using the Alt-Ctrl-Grave key FANSI-CONSOLE _____________ Pressing the Alt-Ctrl-Grave key combination tells FANSI-CONSOLE that you wish to use the original keyboard interrupt processor for the next key combination. Some computers change hardware clock speeds when you press a certain key combination, such as Alt-Ctrl-Backslash, or Alt-Ctrl-DarkPlus and Alt-Ctrl-DarkMinus. Other computers have FANSI- ______ other special keyboard functions when you have not installed FANSI- CONSOLE FANSI-CONSOLE _______ _____________ CONSOLE. When you have installed FANSI-CONSOLE, these key FANSI-CONSOLE _____________ combinations do not work unless FANSI-CONSOLE itself supports that FANSI-CONSOLE _____________ function. So when you have installed FANSI-CONSOLE, you must press the Alt-Ctrl-Grave key combination once before each such key which you want to use. (C) Copyright 1984-86 Hersey Micro Consulting 2-17 (C) Copyright 1984-86 Hersey Micro Consulting 2-17 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly If the special function normally associated with the key combination effects the keyboard or the screen processing, it usually does not FANSI-CONSOLE _____________ work with FANSI-CONSOLE, even if you press the Alt-Ctrl-Grave key combination first. This is because most such functions require continued support after completing the key combination function, and FANSI-CONSOLE _____________ that support cannot be given because FANSI-CONSOLE has replaced the FANSI-CONSOLE _____________ keyboard and screen handling. However, in these cases, FANSI-CONSOLE usually has a similar function which you may do using a different key or some type of control sequence. (C) Copyright 1984-86 Hersey Micro Consulting 2-18 (C) Copyright 1984-86 Hersey Micro Consulting 2-18 FANSI-CONSOLE Starting Quickly _____________ FANSI-CONSOLE Starting Quickly 2.4 How do I uninstall FANSI-CONSOLE? __ _____________ 2.4 How do I uninstall FANSI-CONSOLE? If you ever need to use another application program without having FANSI-CONSOLE _____________ FANSI-CONSOLE installed, because of incompatibility or other reasons, it is just as easy to uninstall as it is to install. The easiest way is to start MS-DOS using a system disk on which you have not FANSI-CONSOLE _____________ installed FANSI-CONSOLE. Another way is to simply remove the "DEVICE=FCONSOLE.DEV" line from the CONFIG.SYS file on your normal system disk. If it is the only FANSI-CONSOLE _____________ line in CONFIG.SYS, then you may uninstall FANSI-CONSOLE by deleting or renaming CONFIG.SYS to another name like CONFIG.TMP. Once you have removed the line from CONFIG.SYS, or removed or renamed CONFIG.SYS, you must restart MS-DOS. You may do this by pressing Alt-Ctrl-Del or by turning your computer off and then on. Simply removing the FCONSOLE.DEV file from your system disk, or FANSI-CONSOLE _____________ renaming it, and restarting MS-DOS also uninstalls FANSI-CONSOLE, but it causes the following error message to be displayed by MS-DOS when it starts: Bad or missing FCONSOLE.DEV Bad or missing FCONSOLE.DEV FANSI-CONSOLE _____________ Usually, if you uninstall FANSI-CONSOLE, you should install the standard MS-DOS ANSI.SYS console driver instead. If you uninstall FANSI-CONSOLE _____________ FANSI-CONSOLE, but you have programs, batch files, or a prompt that use ANSI X3.64 control sequences codes, you need to replace the "DEVICE=FCONSOLE.DEV" line in the CONFIG.SYS file with a line containing "DEVICE=ANSI.SYS". (C) Copyright 1984-86 Hersey Micro Consulting 2-19 (C) Copyright 1984-86 Hersey Micro Consulting 2-19 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation Chapter 3 Chapter 3 Detailed Installation Detailed Installation 3.1 So what is an MS-DOS device driver, anyway? 3.1 So what is an MS-DOS device driver, anyway? FANSI- ______ This chapter describes how to do a detailed installation of FANSI- CONSOLE _______ CONSOLE. It assumes that you have already read the chapter entitled FANSI-CONSOLE _____________ "Starting Quickly". FANSI-CONSOLE has many features, including ___ quicker blink free scrolling, which can not be taken advantage of without this detailed installation. This chapter also describes some features of MS-DOS that the IBM-PC DOS manuals do not describe well. The IBM-PC DOS manuals describe only some of these features. It is definitely hard to find those features which the manuals do describe. IBM has even moved most of this information to a separately purchased manual called the DOS Technical Reference Manual. You need to know these features to FANSI-CONSOLE _____________ understand what FANSI-CONSOLE is and how it works. MS-DOS has provision for people other than IBM or Microsoft to write something called a "loadable device driver". A loadable device driver is Microsoft's excellent answer to the problems that many IBM-PC compatible add-on hardware manufactures had with MS-DOS 1.xx. The problem was that the add-on manufacturers wanted to make their new pieces of hardware work in your computer as though it was really an integral part of the original IBM-PC. To do this, the add-on manufacturers had to create software for their hardware and make it look like part of the original MS-DOS. However, no one gave them the source program for MS-DOS, nor did they give them a standard way to write their software and have MS-DOS include this software into itself as it started up. So everyone started disassembling the operating system and making some ugly programs that patched themselves into the operating system in whatever ways they could figure out. Using two of these programs for two different pieces of add-on hardware would almost invariably cause conflicts and they would not work together. Furthermore, the programs would not work with newer versions of MS-DOS, if for no other reason than that the MS-DOS internal program variable addresses would change. (C) Copyright 1984-86 Hersey Micro Consulting 3-1 (C) Copyright 1984-86 Hersey Micro Consulting 3-1 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation Microsoft solved this by allowing add-on hardware manufacturers to write programs called loadable device drivers to control their hardware ("drive their devices") by following a standard form which Microsoft specified. MS-DOS loads these device drivers at start up time similarly to the original device drivers that come with MS-DOS from your original manufacturer (IBM or your clone maker). This is a new feature of MS-DOS 2.00 and later versions. Now all the add-on hardware manufacturers must do is to give you a driver program in a regular MS-DOS file, and tell you how to include it in your operating system as you start up. IBM even gives two loadable device drivers themselves. One is a console driver called ANSI.SYS and is given in object form. The other is a read/write memory based diskette emulation (RAM disk) given as a listing (source form) in the MS-DOS manual for version 2.0. In version 3.0 they include a similar program in object form called VDISK.SYS. Besides allowing the add-on hardware manufacturers to create driver programs for their hardware, the loadable device drivers can also be used to change the behavior of devices which MS-DOS already supports. FANSI-CONSOLE _____________ This is exactly what FANSI-CONSOLE is all about! The best part is how you incorporate loadable device drivers into MS- DOS. All you must do is create a file called CONFIG.SYS with a few commands in it. MS-DOS always reads this file, if your system disk has one, when it starts and it executes these commands before it does anything else. It does this even before doing the AUTOEXEC.BAT file. Because of the nature of these commands, they may only be done in the CONFIG.SYS file and nowhere else. Just like the AUTOEXEC.BAT file, the CONFIG.SYS file must be in the root directory on your system disk. The command to load a loadable device driver is: DEVICE=<driver file name> <options> DEVICE=<driver file name> <options> The <driver file name> part is the MS-DOS file name of the device driver. If the driver is in a directory other than the root directory, you must use the complete path name. What the <options> part looks like is entirely up to your device driver authors (that's us!). So it looks like whatever they decide. It may look different for different device drivers. Often <options> are unnecessary. The order of the DEVICE commands determines which one MS-DOS loads first. If two drivers have the same name, MS-DOS uses the one loaded last. For example, CON: is the name of the normal MS-DOS console driver, and also the name of the ANSI.SYS device driver, and also FANSI-CONSOLE FANSI- _____________ ______ the name that FANSI-CONSOLE uses. This is why ANSI.SYS or FANSI- CONSOLE _______ CONSOLE replace the normal MS-DOS console driver when you install them. (C) Copyright 1984-86 Hersey Micro Consulting 3-2 (C) Copyright 1984-86 Hersey Micro Consulting 3-2 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation 3.2 What if my needs are ... different? 3.2 What if my needs are ... different? FANSI-CONSOLE _____________ FANSI-CONSOLE has many installation options. They all have default FANSI-CONSOLE FANSI-CONSOLE _____________ _____________ values which FANSI-CONSOLE sets so that FANSI-CONSOLE is as similar to the standard IBM-PC console software as possible. This means, for example, that the installation options which specify hardware dependent values, have defaults that match the needs of the standard FANSI-CONSOLE _____________ IBM-PC display adapters. So, by default, FANSI-CONSOLE should work on all clone computers and adapters. However, if you do not have a FANSI-CONSOLE ______ _____________ standard IBM-PC display adapter, FANSI-CONSOLE probably works better if you change the installation option values. We categorize all display adapters into one of two classes. Which class they belong to depends upon whether they have a hardware deficiency which causes "snow" to appear on the screen when the computer writes to the screen memory at the wrong time. The technical term for the snow is "hashing". This snow is not physically harmful, but it is frequently annoying to anyone reading the screen. For display adapters which may cause snow, you can avoid the snow by making the computer wait for a signal called the "horizontal retrace" before writing to the screen memory. The problem is that this makes the screen writing slower. Depending on what you are doing, you may avoid the snow in other ways. However, it is always a tradeoff of one problem for another. Obviously, because of the ever present tradeoffs, this means that the class of display adapters that cause snow is the "bad" class. The class that does not cause snow is the "good" class. Unfortunately, the standard IBM-PC Color Graphics Adapter (CGA) belongs in the bad class, along with a few clones. Fortunately, the standard IBM-PC Monochrome Display and Printer Adapter (MDPA), the standard Enhanced Graphics Adapter (EGA), and many compatible makers' adapters are in the good class. You can run the SNOW program to determine which class your display adapter belongs in. It will cause snow on the display adapters which belong in the bad class. If no snow appears you have a good display adapter. If you can test a display adapter before making a buying decision, we strongly suggest that you not buy one on which SNOW generates snow! (C) Copyright 1984-86 Hersey Micro Consulting 3-3 (C) Copyright 1984-86 Hersey Micro Consulting 3-3 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation If you have a bad display adapter, the manufacturer designed it that FANSI- ______ way. So do not expect your money back from its manufacturer. FANSI- CONSOLE _______ CONSOLE still speeds it up, but either not as much as one from the good class, or you have to accept some type of drawback. The faster your computer is, the more likely you will accept these drawbacks. FANSI-CONSOLE _____________ Several FANSI-CONSOLE installation options (in particular, /B, /H, /V, and /W) allow you to choose which drawback you would prefer to have. However, we cannot turn a sow's ear into a silk purse. You will not be able to have the best of both worlds without a good display adapter. Regardless of the class of your display adapter, you may use the other installation options to select behavior which you like more than the behavior of the standard IBM-PC console software. You do not need to be a technical genius to figure out how to set the installation options for your computer. It just takes some reading, some thought, and a few minutes time. It only needs to be figured out once, unless you change your needs by, for example, changing your display adapter. You will probably decide it is worth the effort. Do not worry. Unless explicitly specified otherwise in the option descriptions, you can not hurt your computer or your data by experimenting and trying out different installation option settings, even if they turn out to be wrong for your display adapter. All the decisions to be made are a matter of your personal preference. The worst thing that could happen is that you may need to start the installation process over again and make some different decisions. Sometimes the description for an installation option refers to other sections of this user manual. If you feel unsure about how you want to set that installation option after reading the description, you may want to read the other sections before deciding. Again, do not worry. You can always change your choice later. You set the installation options by using "parameter switches" which you add to the end of the MS-DOS configuration command in the CONFIG.SYS file. Each installation option takes the form of an arbitrary number of spaces followed by one slash (or a minus sign, if you prefer), a letter, an equal sign, and a number. If the number FANSI-CONSOLE _____________ starts with a zero, FANSI-CONSOLE considers it a hexadecimal number. FANSI-CONSOLE _____________ Otherwise FANSI-CONSOLE considers it a decimal number. The letter specifies which installation option to set and the number specifies the value of the installation option. It does not matter which case (upper or lower) letters you use. An example is: DEVICE=FCONSOLE.DEV /G=400 /S=10000 DEVICE=FCONSOLE.DEV /G=400 /S=10000 (C) Copyright 1984-86 Hersey Micro Consulting 3-4 (C) Copyright 1984-86 Hersey Micro Consulting 3-4 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation We use many spaces between installation options in this manual, only for clarity. You may use as many spaces as you like, or even no spaces. The one exception is that you must put at least one space after the FCONSOLE.DEV file name, if you specify any installation options. MS-DOS requires this space. Otherwise it could not tell that FANSI-CONSOLE _____________ the installation options are not part of the FANSI-CONSOLE file name. FANSI-CONSOLE _____________ FANSI-CONSOLE processes the installation options in a left to right order. So if you specify an installation option more than once, FANSI-CONSOLE _____________ FANSI-CONSOLE uses only the rightmost instance. The option letters and their meanings are as follows: A - Attributes B - Blinking Scroll Mode C - Color What You Can Mode D - Double Scan Characters F - Font Table Address G - Ctrl-G Bell Length H - Horizontal Delay Mode I - Initialize Controller parameters J - Just DOS Keyboard Macros Mode K - Keyboard Language L - Lock on Scroll-Lock Mode M - Macro Memory Allocated N - No Color Display Mode O - One Finger Typing Mode P - Page Overlap Q - Quick Scroll Mode R - Recall Line Maximum S - Screen Save Timeout T - TTY ROM BIOS Calls Use ANSI X3.64 V - Vertical Delay Mode W - Word Wide Move Mode X - Extended Features Y - Yuck, You Should Be So Compatible Mode Z - Zzzz Sleep Value The following subsections describe each installation option in detail. The chapter entitled "Compatibility and Limitations" indicates appropriate installation option selections for various hardware configurations, when they differ from the defaults. You may change most of these options at run time using control sequences. For more details about these options and changing them at run time, see the chapter entitled "Changing Options at Run-time". Note that the abbreviated ___________ abbreviated user manual found on the diskettes does not include this chapter but the complete printed user manual does. (C) Copyright 1984-86 Hersey Micro Consulting 3-5 (C) Copyright 1984-86 Hersey Micro Consulting 3-5 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation A - Attributes _ __________ A - Attributes Version 1.00 and later Default is /A=00000 FANSI-CONSOLE _____________ This option specifies the response that FANSI-CONSOLE should give to the ANSI X3.64 Device Attributes (DA) command. Setting this option is only important if you have a program expecting to write to a particular ANSI X3.64 terminal, and it wants the exact response for FANSI-CONSOLE _____________ the particular terminal from the DA command. FANSI-CONSOLE treats this option as a two byte number. The high byte specifies the first value returned. The low byte specifies the second value returned. This is easiest to understand when you specify a hexadecimal number, FANSI-CONSOLE _____________ by using a leading zero. So for example, /A=00100 makes FANSI-CONSOLE return the control sequence ESC [ ? 01 ; 00 c. This is the response for a DEC VT101 terminal. The default is /A=00000. We may change this if we get an official implementation number. This option gives the starting value for FANSI-DEVATTR. You may change FANSI-DEVATTR later with the ANSI X3.64 FANSI-SOV command. For more information about the Device Attributes command, see the chapter entitled "ANSI X3.64 Control Sequences". Note that the abbreviated ___________ abbreviated user manual found on the diskettes does not include this chapter but the complete printed user manual does. Related Options: None. (C) Copyright 1984-86 Hersey Micro Consulting 3-6 (C) Copyright 1984-86 Hersey Micro Consulting 3-6 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation B - Blinking Scroll Mode _ ________ ______ ____ B - Blinking Scroll Mode Version 1.00 and later Default is /B=1 FANSI-CONSOLE _____________ This option specifies whether FANSI-CONSOLE should blink the video display on and off when doing a software scroll of the color display in the 25x80 character screen display mode. Using /B=1 (true) means FANSI-CONSOLE _____________ FANSI-CONSOLE blinks as it does a software scroll. Using /B=0 (false) FANSI-CONSOLE _____________ means FANSI-CONSOLE does not blink as it does a software scroll. FANSI-CONSOLE _____________ FANSI-CONSOLE ignores other values. This has no effect on the scrolling unless you also use /H=1 and /Q=0. This option gives the starting value for the FANSI-BLINK mode. You may change FANSI-BLINK later with the ANSI X3.64 FANSI-SM and FANSI- RM commands. Blinking the screen during software scrolling allows the use of a faster scrolling routine that would otherwise cause "snow" on adapters requiring /H=1. If /H=1 must be used, we recommend using FANSI-CONSOLE _____________ /B=1 (unless /W=1). Otherwise FANSI-CONSOLE scrolls about 3.0 times slower. The drawback to blinking is that it is somewhat hard on the eyes. However, this is what the standard IBM-PC console software does, so it appears "normal". The default value is /B=1, because the IBM-PC color graphics adapter requires /H=1. Specifying a /X value may effect the default setting of /B. You must also use /B=0 for some color graphics adapters which do not blink when used with the normal IBM-PC ROM BIOS software. Otherwise the screen save feature (/S option) may not work properly. See the /S option description below. Related options: /H, /Q, /S, /V, /W, /X, /Z. (C) Copyright 1984-86 Hersey Micro Consulting 3-7 (C) Copyright 1984-86 Hersey Micro Consulting 3-7 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation C - Color What You Can Mode _ _____ ____ ___ ___ ____ C - Color What You Can Mode Version 1.01 and later Default is /C=0 FANSI-CONSOLE _____________ This option specifies whether FANSI-CONSOLE should try to force programs to use color or just let them use black and white. Using FANSI-CONSOLE _____________ /C=1 (true) means FANSI-CONSOLE makes many programs which would display only white characters on a black background with /C=0, instead display characters in the current colors and attributes set by the last ANSI X3.64 SGR command. This would normally be the colors and attributes set by the MS-DOS PROMPT command. Using /C=0 (false) FANSI-CONSOLE _____________ means programs display in their normal colors. FANSI-CONSOLE ignores other values. This option gives the starting value for the FANSI-COLOR mode. You may change FANSI-COLOR later with the ANSI X3.64 FANSI-SM and FANSI- RM commands. The default value is /C=0, because it is the IBM-PC compatible setting. We generally suggest /C=1, because it makes many programs use the colors you prefer instead of white on black. However, if you FANSI-CONSOLE _____________ insist that FANSI-CONSOLE colors things the same way as the standard ____ IBM-PC console software, then you must use /C=0. This option is related to the /N option, which has priority over this option. Related options: /N. (C) Copyright 1984-86 Hersey Micro Consulting 3-8 (C) Copyright 1984-86 Hersey Micro Consulting 3-8 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation D - DouBLe SCAN characters _ ______ ____ __________ D - DouBLe SCAN characters Version 1.12 and later Default is /D=0 FANSI-CONSOLE _____________ This option specifies whether FANSI-CONSOLE should use interlace mode or enhanced mode to double the normal number of scan lines per FANSI-CONSOLE _____________ character. Using /D=1 (true) means FANSI-CONSOLE roughly doubles the normal number of scan lines per character. Using /D=0 (false) means FANSI-CONSOLE _____________ FANSI-CONSOLE uses the normal number of scan lines per character. FANSI-CONSOLE _____________ FANSI-CONSOLE ignores other values. This option gives the starting value for the FANSI-DBLSCAN mode. You may change FANSI-DBLSCAN later with the ANSI X3.64 FANSI-SM and FANSI-RM commands. If your monitor does not have a long persistence phosphor, the screen flickers (wavers) when you use interlace. This is a different interlace mode than the 50 line display mode. The default value depends on the type of the adapter and displays. On CGAs the default value is /D=0, because it is the IBM-PC compatible setting. On ECDs the default value is /D=1, because it is the IBM-PC compatible setting. The /D option does not effect MDPAs, or EGAs with regular color displays. Related options: /I. F - Font Table Address _ ____ _____ _______ F - Font Table Address Version 1.00 and later Default is /F=0FA6E This option specifies the offset in the ROM BIOS segment (F000:) of the normal graphics character set. The default offset is /F=0FA6E (hexadecimal), because this is the address used in the standard IBM- PC console software. If you do not set this option appropriately, ________ ______ _______ _____ then the characters displayed in the graphics screen display modes not ___ appear as strange shapes instead of characters. This does not allow you a way to create alternate character sets. It only allows you to specify where the regular graphics character set is in the ROM if you have a non-standard PC. Most people do not need to set this option. This only affects graphics screen display mode characters. It does not effect character screen display mode characters. You may specify alternate character sets for the graphics screen display modes in the usual manner. You can not change this value at run-time. Related options: None. (C) Copyright 1984-86 Hersey Micro Consulting 3-9 (C) Copyright 1984-86 Hersey Micro Consulting 3-9 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation G - Ctrl-G Bell Length _ ______ ____ ______ G - Ctrl-G Bell Length Version 1.00 and later Default is /G=4096 This option specifies the Ctrl-G bell duration. You specify the duration as a delay count measured in about 1/4000 second interval units. This option is independent of how fast your IBM-PC or clone runs. The default is /G=4096 because it is the amount of time used by the standard IBM-PC console software (about one second). If you like your bell a bit shorter, we suggest the bell given by /G=400. Specifying /G=0 turns off the Ctrl-G bell entirely. This option gives the starting value for FANSI-BELL. You may change FANSI-BELL later with the ANSI X3.64 FANSI-SOV command. Related options: None. (C) Copyright 1984-86 Hersey Micro Consulting 3-10 (C) Copyright 1984-86 Hersey Micro Consulting 3-10 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation H - Horizontal Delay Mode _ __________ _____ ____ H - Horizontal Delay Mode Version 1.00 and later Default is /H=1 FANSI-CONSOLE _____________ This option specifies whether FANSI-CONSOLE must wait for the horizontal retrace signal on color graphics adapters before writing to screen memory in the 25x80 character screen display modes. It has no effect for monochrome display adapters or on an EGA. Using /H=1 FANSI-CONSOLE FANSI- _____________ ______ (true) means FANSI-CONSOLE delays. Using /H=0 (false) means FANSI- CONSOLE FANSI-CONSOLE _______ _____________ CONSOLE does not delay. FANSI-CONSOLE ignores other values. This option gives the starting value for the FANSI-HORZDELAY mode. You may change FANSI-HORZDELAY later with the ANSI X3.64 FANSI-SM and FANSI-RM commands. The default value is /H=1, except for EGAs, because the IBM-PC color graphics adapter requires this delay. Otherwise "snow" appears when FANSI-CONSOLE _____________ FANSI-CONSOLE writes to the screen. You may not mind this, but most people do. If your add-on manufacture's color graphics adapter does not require a delay, then using /H=0 gives a much nicer and faster screen display. Using /H=0 makes the 25x80 character screen display modes about 2.0 as fast. If your IBM-PC clone writes slower with FANSI-CONSOLE _____________ FANSI-CONSOLE installed, it is probably because you should use /H=0 and you used /H=1. For EGAs, the default (and only) setting is /H=0. The chapter entitled "Compatibility and Limitations" indicates those display adapters for which /H=0 is appropriate. In addition, we have a test program called SNOW. Just run SNOW to see which way to set the /H option. Specifying a /X option value may effect the default setting of /H. Specifying /H=0, makes the /V and /W options meaningless. The /H option value effects the meaning of the /B option. Related options: /B, /V, /W, /X, /Z. (C) Copyright 1984-86 Hersey Micro Consulting 3-11 (C) Copyright 1984-86 Hersey Micro Consulting 3-11 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation I - Initialize Controller Parameters _ __________ __________ __________ I - Initialize Controller Parameters Version 1.00 and later Default is /I=0 The option is the letter I FANSI-CONSOLE _____________ This option specifies whether FANSI-CONSOLE should use its own internal parameter values for initializing the CRT controller. Using FANSI-CONSOLE _____________ /I=n means FANSI-CONSOLE uses its internal table number n. Using /I=0 FANSI-CONSOLE _____________ means FANSI-CONSOLE should use the table given by the standard IBM-PC FANSI-CONSOLE _____________ console software. Currently, FANSI-CONSOLE has three (3) internal tables. An internal table should be used if you want to give your own starting values different from those given by the standard IBM-PC console software. Generally, we recommend that you do not use /I=n, unless you know how the CRT controller works. So the default value is /I=0. This option gives the starting value for FANSI-CRTTABLE. You may change FANSI-CRTTABLE later with the ANSI X3.64 FANSI-SOV command. To change the values in the internal tables, you must find the tables FANSI-CONSOLE _____________ in your specific version of FANSI-CONSOLE. For more details about this, see the chapter entitled "Changing Options at Run-time". Note abbreviated ___________ that the abbreviated user manual found on the diskettes does not include this chapter but the complete printed user manual does. FANSI-CONSOLE _____________ Earlier versions of FANSI-CONSOLE required the /I=2 option for use with the EGA and a monochrome or color display. Some previous FANSI-CONSOLE _____________ versions of FANSI-CONSOLE required the /I=3 option for use with the EGA and an Enhanced Graphics Display. The current version does not require it. Related options: /D. (C) Copyright 1984-86 Hersey Micro Consulting 3-12 (C) Copyright 1984-86 Hersey Micro Consulting 3-12 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation J - Just DOS Keyboard Macros _ ____ ___ ________ ______ J - Just DOS Keyboard Macros Version 1.10 and later Default is /J=1 FANSI-CONSOLE _____________ This option specifies whether FANSI-CONSOLE should enable IBM-KKR keyboard macros for all keyboard calls, or just for MS-DOS keyboard FANSI-CONSOLE _____________ calls. Using /J=1 (true) means FANSI-CONSOLE enables IBM-KKR keyboard macros only for MS-DOS calls and not for BIOS calls. Using FANSI-CONSOLE _____________ /J=0 (false) means FANSI-CONSOLE enables IBM-KKR keyboard macros for FANSI-CONSOLE _____________ both MS-DOS calls and BIOS calls. FANSI-CONSOLE ignores other values. The default value is /J=1, because it is the IBM-PC compatible setting. This mode affects the macros assigned using IBM-KKR and not the macros assigned using FANSI-KKR. This option gives the starting value for the FANSI-JUSTDOS mode. You may change FANSI-JUSTDOS later with the ANSI X3.64 FANSI-SM and FANSI-RM commands. Related options: None. K - Keyboard Language _ ________ ________ K - Keyboard Language Version 1.13 and later Default is /K=0 This option is not yet fully implemented! This option specifies the keyboard language to be used, as follows: /K=0 means use the USA (US) keyboard. /K=1 means use the French (FR) keyboard. /K=2 means use the German (GR) keyboard. /K=3 means use the Italian (IT) keyboard. /K=4 means use the Spanish (SP) keyboard. /K=5 means use the United Kingdom (UK) keyboard. The default value is /K=0 because it is the IBM-PC compatible setting. This option gives the starting value for FANSI-LANGUAGE. You may change FANSI-LANGUAGE later with the ANSI X3.64 FANSI-SOV command or using the Alt-Ctrl-F1 and Alt-Ctrl-F2 keys. For more details about this option and changing it at run time, see the chapter entitled abbreviated ___________ "Changing Options at Run-time". Note that the abbreviated user manual found on the diskettes does not include this chapter but the complete printed user manual does. Related options: None. (C) Copyright 1984-86 Hersey Micro Consulting 3-13 (C) Copyright 1984-86 Hersey Micro Consulting 3-13 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation L - Lock on Scroll Lock _ ____ __ ______ ____ L - Lock on Scroll Lock Version 1.04 and later Default is /L=0 This option specifies whether to have a one-finger pause key. Using FANSI-CONSOLE _____________ /L=1 (true) means FANSI-CONSOLE makes Scroll-Lock (or Hold on the FANSI- ______ Tandy 1000) the one finger pause key. Using /L=0 (false) means FANSI- CONSOLE _______ CONSOLE does not have a one-finger pause key and Alt-Scroll-Lock is a FANSI-CONSOLE _____________ pause key. FANSI-CONSOLE ignores other values. The default value is /L=0, because it is the IBM-PC compatible setting. This option gives the starting value for the FANSI-LOCK mode. You may change FANSI-LOCK later with the ANSI X3.64 FANSI-SM and FANSI-RM commands. To use the one-finger pause key when you use /L=1, press the Scroll- Lock key to cause the display to pause without flushing the type ahead buffer. This key stroke combination works slightly differently than the Ctrl-Num-Lock combination. Unlike Ctrl-Num-Lock, Scroll-Lock acts as a toggle. When you have disabled the scroll recall feature and you pause, you may use other keys to type ahead without affecting the pause. If you have enabled the scroll recall feature, then you may do scroll recall when paused. Pressing Scroll-Lock a second time clears the pause. Usually Scroll-Lock is more convenient than Ctrl- Num-Lock, mostly because it is a "one finger" pause key. Any program FANSI-CONSOLE _____________ that works with FANSI-CONSOLE pauses with Scroll-Lock. If you use /L=0, you may still do this type of pausing using the Alt-Scroll-Lock key combination instead of Scroll-Lock. Of course, it is then a two finger pause! For other ways to pause, see the descriptions of Ctrl-S and Ctrl-Num-Lock in the chapter entitled "Starting Quickly". FANSI-CONSOLE _____________ When you do not use FANSI-CONSOLE, the Scroll-Lock key has the function of changing the BIOS Scroll-Lock bit. Some application programs, such as Borland's Sidekick and Lotus's 1-2-3, use the FANSI-CONSOLE _____________ Scroll-Lock bit for their own special purposes. So FANSI-CONSOLE must still allow you to change the BIOS Scroll-Lock bit. It must do this even though you have made the Scroll-Lock key the one finger pause key. However, pausing and changing the BIOS Scroll-Lock bit must be two separate functions. So they need different key combinations. You may change the BIOS Scroll-Lock bit by pressing the Alt-Scroll-Lock key combination. Obviously, the Scroll-Lock light must only have one meaning. However, we now have two purposes for the Scroll-Lock key (alone or in a combination). When should the Scroll-Lock light be lit? (C) Copyright 1984-86 Hersey Micro Consulting 3-14 (C) Copyright 1984-86 Hersey Micro Consulting 3-14 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation On PC and XT style computers, the software running on the computer cannot change the Scroll-Lock light, because the original PC did not have a Scroll-Lock light! If you have a PC or XT style computer with status lights on the keyboard, the keyboard itself (not the software!) automatically changes the light in response to your key press. So on these computers, when the Scroll-Lock light is on, it only means that you have pressed the Scroll-Lock key an odd number of times. Since it does this without being told to do so by the software, the light may occasionally get out of synchrony with the FANSI-CONSOLE _____________ BIOS Scroll-Lock bit. Even when you do not use FANSI-CONSOLE, this happens whenever some software changes the BIOS Scroll-Lock bit at some time other than when you press the Scroll-Lock. When you use FANSI-CONSOLE _____________ FANSI-CONSOLE, it gets even more complicated by the two uses of the Scroll-Lock key. The Scroll-Lock light is the exclusive-or of the BIOS Scroll-Lock bit and being paused until some software changes the BIOS Scroll-Lock bit without a keypress, For example, if you press Scroll-Lock and then Alt-Scroll-Lock, the Scroll-Lock light will be off. This will probably surprise you. What you thought was simple, is really complex! So, on these types of computers, the Scroll-Lock light is not always as useful as you might imagine. ___ On AT style computers, the software running on the computer can change the Scroll-Lock light. So on AT style computers, only the key that changes the Scroll-Lock bit also changes the Scroll-Lock light. This is the original, intended meaning of the Scroll-Lock light. The pause key does not change the Scroll-Lock light, so that you may always know the state of the Scroll-Lock bit used by application programs. Therefore, the Scroll-Lock light does not change when you pause. If you use /L=1, this will probably surprise you, because now the Scroll-Lock light changes when you press the Alt-Scroll-Lock key combination and not when you press the Scroll-Lock key. You can tell that you have paused because either the cursor has disappeared, or the scroll recall status bar appears on the screen. For more information about the scroll recall feature, see the description in the chapter entitled "Scroll Recall". Note that the abbreviated ___________ abbreviated user manual found on the diskettes does not include this chapter but the complete printed user manual does. Related options: /P, /R. (C) Copyright 1984-86 Hersey Micro Consulting 3-15 (C) Copyright 1984-86 Hersey Micro Consulting 3-15 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation M - Macro Memory Allocated _ _____ ______ _________ M - Macro Memory Allocated Version 1.00 and later Default is /M=1024 This option specifies how much read/write memory to reserve for FANSI-CONSOLE _____________ varying space requirements. FANSI-CONSOLE uses this memory for saving ANSI X3.64 command parameters and keyboard macro strings. The value to specify is measured in bytes. The default is /M=1024. and the minimum value is /M=256. The maximum value is about /M=30000. If you FANSI-CONSOLE _____________ use a value out of range, then FANSI-CONSOLE uses the appropriate limit instead. You can not change this value at run-time. FANSI-CONSOLE _____________ When FANSI-CONSOLE runs out of space for macros, it stores as much of a new macro as it can and discards the rest. When this happens, it also beeps once. It does not produce an error message. You can detect FANSI-CONSOLE _____________ this space problem by forcing FANSI-CONSOLE to expand the last key you tried to define. If it does not expand completely, then you need to use a larger /M value. To estimate your requirements, add your total keyboard macro string lengths to twice the length of your longest keyboard macro. The length of a keyboard macro string is the number of characters which get entered when you press the key. Then add 100 and multiply by 2.5. Remember that this is only an estimate. You may be able to do with less space. For more information about keyboard macros, see the section entitled FANSI-CONSOLE _____________ "How do I assign strings to FANSI-CONSOLE keys?" in the chapter abbreviated ___________ entitled "Keyboard Assignment". Note that the abbreviated user manual found on the diskettes does not include this chapter but the complete printed user manual does. Related options: None. (C) Copyright 1984-86 Hersey Micro Consulting 3-16 (C) Copyright 1984-86 Hersey Micro Consulting 3-16 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation N - No Color Display _ __ _____ _______ N - No Color Display Version 1.07 and later Default is /N=0 FANSI-CONSOLE _____________ This option specifies whether FANSI-CONSOLE should let programs use color or try to force them to use just black and white. This does not affect programs which write directly to the screen memory. Using /N=1 FANSI-CONSOLE _____________ (true) means FANSI-CONSOLE makes some programs which would use color with /N=0, instead display characters in black and white. Using /N=0 FANSI-CONSOLE _____________ (false) means programs display in their normal colors. FANSI-CONSOLE ignores other values. This option gives the starting value for the FANSI-NOCOLOR mode. You may change FANSI-NOCOLOR later with the ANSI X3.64 FANSI-SM and FANSI-RM commands. The default value is /N=0, because it is the IBM-PC compatible setting. We generally suggest /N=0, unless you have a monochrome display connected to a color display adapter and you can not read some colored characters on your display. This option is related to the /C option, which this option has priority over. Related options: /C. (C) Copyright 1984-86 Hersey Micro Consulting 3-17 (C) Copyright 1984-86 Hersey Micro Consulting 3-17 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation O - One Finger Typing _ ___ ______ ______ O - One Finger Typing Version 1.00 and later Default is /O=0 The option is the letter O FANSI-CONSOLE _____________ This option specifies whether FANSI-CONSOLE should allow one finger FANSI-CONSOLE _____________ typing. Using /O=1 (true) means FANSI-CONSOLE toggles the Alt, Ctrl, or shift key states only when you press the appropriate keys, and not when you release them. This means that you remain Alt'ed, Ctrl'ed, or shifted until you press the same key again. Note that in this situation, each shift key is a separate shift lock and both must be FANSI- ______ off to get unshifted characters. Using /O=0 (false) means FANSI- CONSOLE _______ CONSOLE toggles the Alt, Ctrl, or shift key state both when you press FANSI-CONSOLE _____________ the appropriate key, and when you release it. FANSI-CONSOLE ignores other values. The default value is /O=0, because this gives the normal behavior of keyboards. This option gives the starting value for the FANSI-HANDICAP shift mode. You may change FANSI-HANDICAP later with the ANSI X3.64 FANSI- SM and FANSI-RM commands. The /O option is for handicappers and others for whom it is impractical to press multiple keys at once, such as both the control not key and an alphabetic key. If you are not physically handicapped, you probably want to use /O=0. This option has nothing to do with whether you touch type versus whether you hunt and peck. Related options: /L, /R. (C) Copyright 1984-86 Hersey Micro Consulting 3-18 (C) Copyright 1984-86 Hersey Micro Consulting 3-18 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation P - Page Overlap _ ____ _______ P - Page Overlap Version 1.08 and later Default is /P=4 This option specifies the number of lines of overlap between pages used by the scroll recall feature. Using /P=0 also implies that no status line should be shown on the recall screen, so that you may see the whole screen. Using /P with a value more than zero also implies that a status line should be shown at the top of the recall screen. The default value is /P=4. This option gives the starting value for FANSI-OVERLAP. You may change FANSI-OVERLAP later with the ANSI X3.64 FANSI-SOV command, or the DarkPlus and DarkMinus keys in the scroll recall mode. For more information about the scroll recall feature, see the section entitled "How do I recall lines which have scrolled away?" in the abbreviated ___________ chapter entitled "Scroll Recall". Note that the abbreviated user manual found on the diskettes does not include this chapter but the complete printed user manual does. Related options: /L, /R. (C) Copyright 1984-86 Hersey Micro Consulting 3-19 (C) Copyright 1984-86 Hersey Micro Consulting 3-19 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation Q - Quick Scroll Mode _ _____ ______ ____ Q - Quick Scroll Mode Version 1.17 and later Default is /Q=0 FANSI-CONSOLE _____________ This option specifies whether FANSI-CONSOLE should use quick hardware scrolling or slow software scrolling when scrolling the entire screen in character screen display modes. Hardware scrolling is usually much faster than the software scrolling normally used by the IBM-PC ROM BIOS. It is usually 1.5 to 3.0 times faster. Hardware scrolling also does not blink, regardless of the /B option setting (FANSI-BLINK). Note that hardware scrolling can only scroll the entire screen. Software scrolling must always be used when scrolling FANSI-CONSOLE _____________ only part of the screen. Using /Q=1 (true) means FANSI-CONSOLE sets FANSI-QUICK at the start and uses hardware scrolling. Using /Q=0 FANSI-CONSOLE _____________ (false) means FANSI-CONSOLE resets FANSI-QUICK at the start and uses software scrolling. In graphics modes, hardware scrolling cannot be FANSI-CONSOLE FANSI-CONSOLE _____________ _____________ done, so FANSI-CONSOLE uses software scrolling. FANSI-CONSOLE ignores other values. This option gives the starting value for the FANSI-QUICK mode. You may change FANSI-QUICK later with the ANSI X3.64 FANSI-SM and FANSI- RM commands. The hardware scrolling can only used if the display adapter has at least 16 KB of screen memory, and allows it all to be used in the character screen display modes. Essentially this means that hardware scrolling can only be used on CGAs and EGAs, and not on MDPAs. The default value is /Q=0, because it is the IBM-PC compatible setting. We generally suggest /Q=1, because it makes the scrolling much faster and does not blink during scrolling. Only a few programs FANSI- ______ are incompatible with this mode. However, if you insist that FANSI- CONSOLE _______ CONSOLE be compatible with and scroll the same way as the standard ____ IBM-PC console software, then you must use /Q=0. Related Options: /B. (C) Copyright 1984-86 Hersey Micro Consulting 3-20 (C) Copyright 1984-86 Hersey Micro Consulting 3-20 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation R - Recall Line Maximum _ ______ ____ _______ R - Recall Line Maximum Version 1.08 and later Default is /R=0 This option specifies how many lines of space to reserve for the FANSI-CONSOLE _____________ scroll recall feature buffer. Using /R=0 means that FANSI-CONSOLE should reserve no space for the scroll recall feature, which means that you can not use scroll recall. Using a non-zero value for /R FANSI-CONSOLE _____________ implies that FANSI-CONSOLE initially turns the scroll recall feature FANSI- ______ on. Using a non-zero value for /R less than 50 implies that FANSI- CONSOLE _______ CONSOLE reserves 50 lines for scroll recall, because there must be enough room in the buffer for at least one screenful, and screens may be as much as 50 lines high. A value for /R of at least 50 indicates FANSI-CONSOLE _____________ that FANSI-CONSOLE reserves exactly that many lines of memory for scroll recall. Each line reserved requires 160 bytes of memory. For example, /R=100 requires about 16 KB more read/write memory than /R=0. The default value is /R=0, because this gives the minimum space usage and maximum compatibility. You can frequently save more lines than the number you FANSI-CONSOLE _____________ specify, because the compression done by FANSI-CONSOLE causes most lines to require less than 160 bytes of memory. FANSI-CONSOLE _____________ If you load an Expanded Memory Manager before FANSI-CONSOLE in the FANSI-CONSOLE _____________ CONFIG.SYS file, then FANSI-CONSOLE allocates the scroll recall FANSI-CONSOLE _____________ feature buffer from Expanded Memory. Otherwise FANSI-CONSOLE uses regular read/write memory. Using regular read/write memory is slightly faster, but it reduces the remaining space usable by MS-DOS and application programs. FANSI-CONSOLE _____________ If FANSI-CONSOLE stores the scroll recall feature buffer in regular read/write memory, then the only limit on the /R value is the limit imposed by the total amount of regular read/write memory your computer has. For example, it can also be /R=800, if you do not mind using about 128 KB for scroll recall. You can not change the regular read/write memory space reservation at run-time. FANSI-CONSOLE _____________ If FANSI-CONSOLE stores the scroll recall feature buffer in Expanded FANSI- ______ Memory, the most space that you can allocate for use with the FANSI- CONSOLE _______ CONSOLE scroll recall feature is 1 megabyte (MB), or the remaining unused Expanded Memory space, whichever is smaller. One MB is about 6553 lines. It still depends on the size of the lines, though! If there is not enough unused space for the number of lines specified, FANSI-CONSOLE _____________ then FANSI-CONSOLE uses the remaining Expanded Memory. You can change Expanded Memory space reservation at run-time. This option gives the starting value for FANSI-RECALL. You may change FANSI-RECALL later with the ANSI X3.64 FANSI-SOV command. (C) Copyright 1984-86 Hersey Micro Consulting 3-21 (C) Copyright 1984-86 Hersey Micro Consulting 3-21 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation For more information about the scroll recall feature, see the section entitled "How do I recall lines which have scrolled away?" in the abbreviated ___________ chapter entitled "Scroll Recall". Note that the abbreviated user manual found on the diskettes does not include this chapter but the complete printed user manual does. Related options: /L, /P. (C) Copyright 1984-86 Hersey Micro Consulting 3-22 (C) Copyright 1984-86 Hersey Micro Consulting 3-22 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation S - Screen Save Timeout _ ______ ____ _______ S - Screen Save Timeout Version 1.00 and later Default is /S=0 FANSI-CONSOLE _____________ This option specifies whether FANSI-CONSOLE should use its screen saver feature and how long the timeout should be. The value used is the number of about 1/18.2 second interval units counted before turning off the display. If you do not press any keys and the current program does no screen writing using ROM BIOS calls or MS-DOS before FANSI-CONSOLE _____________ the timeout, FANSI-CONSOLE automatically turns off the console screen display. This prevents you from accidentally permanently burning a pattern into your display screen by displaying the same thing on the FANSI-CONSOLE _____________ screen too long. When FANSI-CONSOLE turns off the display, you can turn the display back on by pressing any key, including a shifting FANSI-CONSOLE _____________ key. When FANSI-CONSOLE turns the display back on, the data displayed FANSI-CONSOLE _____________ appears the same as it did just before FANSI-CONSOLE turned off the display. You may use the default count of /S=0 to specify always keeping the screen display on, which is the behavior of the standard IBM-PC console software. We do not recommend this setting, but we make the defaults as compatible as possible with the standard, to avoid surprising people. Otherwise you can make the timeout as much as about one hour if you use /S=65535 (0FFFF). We suggest /S=10000. for a timeout of about ten minutes. 18.2 units/sec * 60 secs/min * 10 min = 10920 units, actually. This option gives the starting value for FANSI-SCRNTIME. You may change FANSI-SCRNTIME later with the ANSI X3.64 FANSI-SOV command. FANSI-CONSOLE _____________ FANSI-CONSOLE automatically tests for the Hercules Graphics Card and clones. When it finds one, it uses special screen save routines equivalent to the routines used by Hercules Computer Technology. So you may ignore their warnings about using other screen save programs. (C) Copyright 1984-86 Hersey Micro Consulting 3-23 (C) Copyright 1984-86 Hersey Micro Consulting 3-23 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation You must use /B=0 for some color graphics adapters which do not blink when used with the normal IBM-PC ROM BIOS software. Otherwise the screen save feature may not work properly. If you specify the /S option, and the screen timeout only turns off the cursor, then try adding the /B=0 option along with various /Z option settings. If you specify the /S option and /B=0 option, and the screen displays garbage when the screen save timeout occurs, then use the /B=1 option. If neither the /B=0 nor the /B=1 options work with the /S option, then the manufacturer designed the hardware so that there is no way to turn off the screen display. There is no way to have the /S option work with such adapters. It may also be that the way the video signal enable is turned off is different from that required by IBM FANSI-CONSOLE _____________ standard adapters. FANSI-CONSOLE may have an extended features option which you must use with such an adapter. See the /X option description below. Related options: /B, /X, /Z. T - TTY ROM BIOS Calls Use ANSI X3.64 _ ___ ___ ____ _____ ___ ____ _____ T - TTY ROM BIOS Calls Use ANSI X3.64 Version 1.00 and later Default is /T=0 FANSI-CONSOLE _____________ This option specifies whether FANSI-CONSOLE should process ANSI X3.64 standard control sequences for the ROM BIOS video call for TTY output FANSI- ______ (INT 10 hex with AH = 15 decimal). Using /T=1 (true) means FANSI- CONSOLE _______ CONSOLE processes the ANSI X3.64 standard control sequences found in FANSI-CONSOLE _____________ the TTY output calls. Using /T=0 (false) means FANSI-CONSOLE processes the TTY output calls in a way compatible with the standard FANSI-CONSOLE _____________ IBM-PC console software. FANSI-CONSOLE ignores other values. This option gives the starting value for the FANSI-TTY mode. You may change FANSI-TTY later with the ANSI X3.64 FANSI-SM and FANSI-RM commands. The default value is /T=0. We generally recommend /T=0, for compatibility. With /T=1, you may force some communications programs to process ANSI X3.64 control sequences properly, and emulate an ANSI X3.64 standard terminal, even when those programs do not normally have that as a feature. Specifying /T=1 is only incompatible with a few programs which use the TTY call to display IBM-PC characters whose values are less than the value of a space. Related options: None. (C) Copyright 1984-86 Hersey Micro Consulting 3-24 (C) Copyright 1984-86 Hersey Micro Consulting 3-24 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation V - Vertical Delay Mode _ ________ _____ ____ V - Vertical Delay Mode Version 1.00 and later Default is /V=1 FANSI-CONSOLE _____________ This option specifies whether FANSI-CONSOLE should wait for the vertical retrace signal to go on before blinking the video display when scrolling the color display in the 25x80 character screen display mode. It has no effect for monochrome display adapters. It FANSI-CONSOLE _____________ has no effect if /B=0. Using /V=1 (true) means FANSI-CONSOLE waits. FANSI-CONSOLE FANSI-CONSOLE _____________ _____________ Using /V=0 (false) means FANSI-CONSOLE does not wait. FANSI-CONSOLE ignores other values. This option gives the starting value for the FANSI-VERTDELAY mode. You may change FANSI-VERTDELAY later with the ANSI X3.64 FANSI-SM and FANSI-RM commands. If /B=1 must be used, we recommend also using /V=1 because it makes the blink slightly less annoying. The drawback to waiting with /V=1 is that it slows the scrolling speed slightly. However, this is what the standard IBM-PC console software does, so it appears "normal". The default value is /V=1, because /B=1 is also the default. Related options: /B, /H, /W. (C) Copyright 1984-86 Hersey Micro Consulting 3-25 (C) Copyright 1984-86 Hersey Micro Consulting 3-25 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation W - Word Wide Move Mode _ ____ ____ ____ ____ W - Word Wide Move Mode Version 1.00 and later Default is /W=0 FANSI-CONSOLE _____________ This option specifies whether FANSI-CONSOLE should move a whole word at a time to the screen after waiting for horizontal retrace. It has no effect for monochrome display adapters. It has no effect if /H=0. FANSI-CONSOLE _____________ Using /W=1 (true) means FANSI-CONSOLE moves a word at a time. Using FANSI-CONSOLE FANSI- _____________ ______ /W=0 (false) means FANSI-CONSOLE moves a byte at a time. FANSI- CONSOLE _______ CONSOLE ignores other values. This option gives the starting value for the FANSI-WORDWIDE mode. You may change FANSI-WORDWIDE later with the ANSI X3.64 FANSI-SM and FANSI-RM commands. If it does not cause "snow" on the screen, we recommend using /W=1 because it makes the software scrolling about 1.15 times faster in the 25x80 character screen display modes. However, /W=0 is the default because /W=1 causes hashing on the IBM-PC graphics adapter on an IBM-PC. Generally, only machines with a 16-bit wide data bus and an 8086, 80186, or 80286 like the IBM-PC AT, the AT&T PC, or DeskPro are fast enough for /W=1 to not cause snow. The chapter entitled "Compatibility and Limitations" indicates those machines for which /W=1 is appropriate. In addition we have a test program called SNOW. Just run SNOW to see which way to set the /W option to avoid snow. Even if the /W=1 option setting causes snow, it may not be enough to annoy you. Specifying a /X value may effect the default setting of /W. Related options: /B, /H, /V. (C) Copyright 1984-86 Hersey Micro Consulting 3-26 (C) Copyright 1984-86 Hersey Micro Consulting 3-26 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation X - Extensions _ __________ X - Extensions Version 1.01 and later Default is /X=0 FANSI-CONSOLE _____________ This option specifies whether FANSI-CONSOLE should use extensions peculiar to a particular computer. If you have hardware which must ____ requires an extension, you must set the corresponding /X option. This is because these computers are not exactly IBM-PC or IBM-PC AT compatible in some way. Although we describe them briefly, you do not need to understand the reasons. /X=0 means use no extensions, and is therefore the default. /X=1 (V1.01) means use Zenith Z150/160 extensions. If you do not use /X=1 for a Zenith Z150/160, then using the /S option with a non-zero value does not turn off the screen display. Also changes defaults to /H=0. /X=2 (V1.02) means use Mad-1/Goupil G4 extensions. If you do FANSI- ______ not use /X=2 for a Mad-1 or Goupil G4, then FANSI- CONSOLE _______ CONSOLE ignores the break key and the numeric pad comma key. /X=3 (V1.09) means use AT&T 6300/Olivetti M24/Xerox 6065 extensions. If you do not use /X=3 for an AT&T 6300 or FANSI-CONSOLE _____________ Olivetti M24, the FANSI-CONSOLE does not light the keyboard status lights. Because of a pair of bugs in the FANSI-CONSOLE _____________ original AT&T 6300/Olivetti M24 BIOS ROMs, FANSI-CONSOLE also hangs the computer without this option. The new ROMs are preferable! Also changes defaults to /B=0/W=1. Also we suggest you try adding /B=1. It blinks when it software scrolls, but it is much faster. /X=4 (V1.10) means use Tandy 1000 extensions. If you do not use /X=4 for a Tandy 1000, then keys on and near the numeric key pad do not always generate the values indicated by the key top labels. Also changes defaults FANSI-CONSOLE _____________ to /H=0. When FANSI-CONSOLE is installed, you do not need to run KEYCNVRT.SYS. /X=5 (V1.12) means use Data General One extensions. If you do not use /X=5 for a Data General One, then shifted arrow keys do not generate the expected values. Also changes defaults to /H=0. /X=6 (V1.16) means use Tandem PC extensions. If you do not use /X=6 for a Tandem PC, then the extra keys do not FANSI-CONSOLE _____________ generate the expected values. FANSI-CONSOLE does not support the CONFIG key, though. (C) Copyright 1984-86 Hersey Micro Consulting 3-27 (C) Copyright 1984-86 Hersey Micro Consulting 3-27 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation FANSI-CONSOLE _____________ FANSI-CONSOLE ignores other values. You can not change this value at run-time. We may add other /X values when we discover that the extensions for one display adapter or computer are incompatible with other display adapters or computers. Check the FCONSOLE.HST file for any recently added values. Related options: /B, /H, /W. (C) Copyright 1984-86 Hersey Micro Consulting 3-28 (C) Copyright 1984-86 Hersey Micro Consulting 3-28 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation Y - Yuck, You Should Be So Compatible _ _____ ___ ______ __ __ __________ Y - Yuck, You Should Be So Compatible Version 1.00 and later Default is /Y=1 FANSI-CONSOLE _____________ This option specifies whether FANSI-CONSOLE should be as compatible as it can be to the standard IBM-PC console software by always looking at the ROM BIOS screen variables. Using /Y=1 (true) means FANSI-CONSOLE _____________ FANSI-CONSOLE always looks at the ROM BIOS screen variables. Using FANSI-CONSOLE _____________ /Y=0 (false) means FANSI-CONSOLE seldom looks at the ROM BIOS screen FANSI-CONSOLE _____________ variables. FANSI-CONSOLE ignores other values. This option gives the starting value for the FANSI-CMP mode. You may change FANSI-CMP later with the ANSI X3.64 FANSI-SM and FANSI-RM commands. FANSI-CONSOLE _____________ In designing FANSI-CONSOLE, we had to make a few tough decisions. Certain programs directly modify ROM BIOS screen variables themselves before making calls to ROM BIOS screen routines to make other changes. This is not a proper way of doing things, because it violates the intended purpose of the ROM BIOS, but some programs did it anyway. The practice is sometimes called "making endruns around the BIOS". The proper way is to make calls to the appropriate ROM BIOS screen routines to make all the changes. FANSI-CONSOLE _____________ The problem is that, if FANSI-CONSOLE is to be fast and to also have some of its other features, it has to use its own internal variables FANSI-CONSOLE _____________ and not the ROM BIOS screen variables. However, if FANSI-CONSOLE does not look at the ROM BIOS screen variables, these programs do not run correctly. When these programs run, it looks like most characters are overwritten, in the wrong place, and the screen is mostly empty. So the choice is to be fast, or to be compatible. Since you may have already purchased some of these improperly written programs, we leave the decision up to you. The /Y option is a way for you to make this decision. FANSI-CONSOLE _____________ Using /Y=1 means that FANSI-CONSOLE should start out being more not ___ compatible but slightly slower. This does not mean totally compatible (nothing ever could be), but it is as close as we have figured out how to be and still be fast. This also means that some extended features are unusable. Particularly, it means that you may use only 8 screen pages, and that you may not use the extended 50 line interlaced screen display modes. Currently, the speed penalty is about 7% for MS-DOS calls, and about 20% for BIOS calls. So you may not even notice the difference. The penalty may become greater in later versions, if we discover more things that we may do to increase compatibility. (C) Copyright 1984-86 Hersey Micro Consulting 3-29 (C) Copyright 1984-86 Hersey Micro Consulting 3-29 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation FANSI-CONSOLE _____________ Using /Y=0 means that FANSI-CONSOLE should start out being faster but slightly incompatible. It also allows you to use some extended features. This gives enough compatibility to run most but not all programs. Using this mode is a way to test the portability of a program. If it does not run correctly in this mode, it may have problems running on some "almost but not quite" IBM-PC clones. Of course, it does not mean that a program is portable just because it runs in this mode. The default is /Y=1, because this gives normal behavior for as many of your applications as possible. Where it is known that /Y=1 is required for a specific program, it is noted in the compatibility lists. Generally, we recommend using /Y=1. Related Options: None. (C) Copyright 1984-86 Hersey Micro Consulting 3-30 (C) Copyright 1984-86 Hersey Micro Consulting 3-30 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation Z - Zzzz Sleep Value _ ____ _____ _____ Z - Zzzz Sleep Value Version 1.14 and later Default is /Z=34 (022 hex) FANSI-CONSOLE _____________ This option specifies the byte that FANSI-CONSOLE should use to turn off the color screen display for the screen save timeout when you use /H=0/B=0. Unless you use /H=0/B=0 with a color display adapter, FANSI-CONSOLE FANSI-CONSOLE _____________ _____________ FANSI-CONSOLE ignores this option. FANSI-CONSOLE sends the /Z value to the adapter address 03d8 hex to turn off the display. Unless the screen save feature does not work when /H=0/B=0 is selected, do not change this value. This option gives the starting value for FANSI-ZSLEEP. You may change FANSI-ZSLEEP later with the ANSI X3.64 FANSI-SOV command. The default is 34 (022 hex), since this is the most likely value to be safe and successful at performing the screen save feature. Other likely values to try are P2=18 (012 hex), P2=22 (016 hex), and P2=38 (026 hex). DO NOT PERMANENTLY USE ANY /Z VALUE WHICH CAUSES AN UNUSUAL HIGH DO NOT PERMANENTLY USE ANY /Z VALUE WHICH CAUSES AN UNUSUAL HIGH PITCHED SCREAM FROM YOUR MONITOR DURING A SCREEN SAVE! DAMAGE TO YOUR PITCHED SCREAM FROM YOUR MONITOR DURING A SCREEN SAVE! DAMAGE TO YOUR MONITOR MAY RESULT! MONITOR MAY RESULT! If the screaming occurs, it starts immediately when the screen save starts. If your monitor starts screaming at an unusual pitch, press a key immediately to end the screen save, or turn off your computer. Then restart your computer with a different /Z option value or with /B=1. Monitor sounds which are the same as those normally made in medium and high resolution graphics modes and in character screen display modes are OK. Related Options: /B, /H, /S. (C) Copyright 1984-86 Hersey Micro Consulting 3-31 (C) Copyright 1984-86 Hersey Micro Consulting 3-31 FANSI-CONSOLE Detailed Installation _____________ FANSI-CONSOLE Detailed Installation 3.3 How much memory does FANSI-CONSOLE require? _____________ 3.3 How much memory does FANSI-CONSOLE require? FANSI-CONSOLE _____________ FANSI-CONSOLE memory requirements vary depending on the options that you select and the type of computer you run it on. However, you can estimate the requirements when you need to cut the fat because of lack of memory. FANSI-CONSOLE _____________ The starting point for calculating the resident size of FANSI-CONSOLE is the size of the file FCONSOLE.DEV. This is currently about 40 KB. FANSI- ______ Currently, there is about 4 KB of initialization code in FANSI- CONSOLE _______ CONSOLE which never remains resident. This includes all the code for the various /X options. In addition, there is another 4 KB of code for the EGA which only remains resident if you have an EGA installed. Both or one of these amounts should be subtracted from the file size, depending on whether you have an EGA installed. To this reduced file size, you must add the amount of memory reserved for macro strings and parameters. Add the value of the /M option or its default. If it is not stored in Expanded Memory, you must also add the number of bytes reserved for scroll recall. Calculate this from the /R option or its default, as described earlier in this chapter. (C) Copyright 1984-86 Hersey Micro Consulting 3-32 (C) Copyright 1984-86 Hersey Micro Consulting 3-32 FANSI-CONSOLE Programming Background _____________ FANSI-CONSOLE Programming Background Chapter 4 Chapter 4 Programming Background Programming Background 4.1 Which screen writing method is best? 4.1 Which screen writing method is best? This chapter describes screen and keyboard usage methods and their portability to other computers. It is an introduction for the next few chapters, to help you decide which type of screen writing method to use in your programs. You do not need to read it unless you write programs for your computer. You might want to read it anyway, if you are curious, since it is not too technical. There are three general ways to use the screen and keyboard: 1. Direct hardware manipulation. 2. ROM BIOS calls. 3. MS-DOS calls. Each has its own advantages and disadvantages. As you move down our list above, the methods generally become somewhat slower and less versatile but they also become more computer independent. It is probably obvious why you would want your programs to write to the screen as fast as possible. What may not be obvious is why you might want them to be computer independent. (C) Copyright 1984-86 Hersey Micro Consulting 4-1 (C) Copyright 1984-86 Hersey Micro Consulting 4-1 FANSI-CONSOLE Programming Background _____________ FANSI-CONSOLE Programming Background The more computer independent a program is, the more likely it is that the program will run on your particular computer. Sure, you bought your IBM-PC or clone because it is (or is equivalent to) what everyone else bought. We are sure you have heard stories from friends about how great some IBM-PC adapter was but it was not "IBM-PC compatible". By the way, we like the word "equivalent" better than "compatible", when used in this context. We are also sure that you have at one time or another heard other stories about how parts of the IBM-PC are badly designed. Not that we agree with all such complaints. The problem is that it is impossible to improve on IBM's ideas if everything must be the same as IBM's! So pick one, please. Which will it be: "equivalent" or "better than IBM's"? Well, if more programs used more computer independent methods to use the hardware on your IBM-PC, you could have your cake and eat it too. For example, consider that many programs use the first screen writing method: direct hardware manipulation. If someone (even IBM) designed a hot new video board for the IBM-PC that allowed you to display 80 lines of 132 columns of text, none of these programs would work with this board. There are some boards that can do this! So you paid a high price for all the speed of direct screen writing: you must buy an equivalent board. If the same programs instead called the ROM BIOS or the DOS to do screen writing, all that the screen board manufacturer would need to do is to provide a replacement for part of the ROM BIOS or part of MS-DOS for screen writing. A good example of the problems faced is the number of programs which now need to be modified to support the new IBM Enhanced Graphics Adapter (EGA). If the authors had written these programs to use ROM BIOS calls in the first place, they would not need to modify them now, since IBM included a new ROM BIOS on the EGA itself. It turns out that the IBM-PC ROM BIOS is slow. Since MS-DOS calls also call the IBM-PC ROM BIOS, they are also slow. Anyway, the price for computer independence is much higher than it needs to be. How do FANSI-CONSOLE _____________ we know? This is what FANSI-CONSOLE is all about! It replaces the standard IBM-PC ROM BIOS software for the screen and keyboard with FANSI-CONSOLE _____________ our own BIOS software. The result is that FANSI-CONSOLE speeds up programs which use the BIOS or MS-DOS calls for screen writing. It also did not help that most things that you could do directly to the screen you can not do with some type of MS-DOS call. The introduction of the concept of an MS-DOS device driver remedied this somewhat. (C) Copyright 1984-86 Hersey Micro Consulting 4-2 (C) Copyright 1984-86 Hersey Micro Consulting 4-2 FANSI-CONSOLE Programming Background _____________ FANSI-CONSOLE Programming Background There are several reasons that MS-DOS calls should be used instead of ROM BIOS calls, wherever feasible: 1. The MS-DOS calls provide some functions in a more convenient manner for the programmer than the BIOS does. In particular, they are the easiest to use in most languages other than assembly language. 2. You may redirect program screen displays into an MS-DOS file instead of directing them to the screen. From there you can manipulate them just like any other data file. 3. You may use the program with the CTTY program on an external terminal via your serial port. 4. Even more computers using MS-DOS support the ANSI X3.64 standard through MS-DOS calls than those supporting an equivalent to the IBM-PC ROM BIOS. The interrupt vectors used by the IBM-PC ROM BIOS standard violate Intel's reservation of them for its newer processors like the 80186. So not all computers which could otherwise be equivalent have the possibility of using these vectors for screen writing or keyboard reading. So the program could be run on more machines now, and in the future. Remember though, that the price we pay for portability is some speed and some versatility. But the price does not have to be unbearable, FANSI-CONSOLE _____________ if you use FANSI-CONSOLE. (C) Copyright 1984-86 Hersey Micro Consulting 4-3 (C) Copyright 1984-86 Hersey Micro Consulting 4-3 FANSI-CONSOLE Programming Background _____________ FANSI-CONSOLE Programming Background 4.2 How do I detect whether FANSI-CONSOLE is installed? _____________ 4.2 How do I detect whether FANSI-CONSOLE is installed? You may want to write programs with capabilities which depend on FANSI-CONSOLE _____________ having FANSI-CONSOLE installed. Any program may test for whether FANSI-CONSOLE FANSI-CONSOLE _____________ _____________ FANSI-CONSOLE is installed. FANSI-CONSOLE has another device name besides CON:. It may also be opened as FCON:. So, to test for whether FANSI-CONSOLE _____________ FANSI-CONSOLE is installed, simply have the program attempt to open FANSI-CONSOLE _____________ the device FCON:. If the open attempt succeeds, then FANSI-CONSOLE is FANSI-CONSOLE _____________ installed. If the open attempt fails, then FANSI-CONSOLE is not FANSI-CONSOLE _____________ installed. If FANSI-CONSOLE is not installed, you may want your program to print an error message, or just use a slightly different mechanism for screen writing. MS-DOS only checks the first part of a file name, the characters before the extension, when it determines whether the file name is a device name. It ignores the file name extension when it does this. So FANSI-CONSOLE _____________ when FANSI-CONSOLE is installed, you can not read or write files with names like FCON.XXX. This includes directories! If you try, you are really using FCON: instead. If you write to it, the data is written to the console. If you read from it, the data is read from the keyboard. MS-DOS processes CON: differently from FCON: slightly. For some MS- DOS calls, MS-DOS itself automatically expands HT characters into a destructive tab for CON:, before calling the console driver. For those calls, the HT tabs to the next column with a remainder of 1 when divided by 8, filling with spaces as it goes, and it treats previous control sequences as though they consumed columns on the screen. MS-DOS does not do this for FCON:. This means that if you give HT characters to FCON:, it treats them as graphic characters and not expanded as tabs, unless FANSI-CONTROL or FANSI-VT100 are set. (C) Copyright 1984-86 Hersey Micro Consulting 4-4 (C) Copyright 1984-86 Hersey Micro Consulting 4-4 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations Chapter 13 Chapter 13 Compatibility and Limitations Compatibility and Limitations 13.1 What do I do if FANSI-CONSOLE gives me problems? _____________ 13.1 What do I do if FANSI-CONSOLE gives me problems? FANSI-CONSOLE _____________ If you think that FANSI-CONSOLE causes a problem, you should do ______ several things before calling us. They help pin down the problem, and reduce the time spent on the phone with us. First, remember to do all your testing on the same computer that you had problems with, and configure it the same way as when you had the problems. 13.1.1 Check for the problem in the index under "problem" 13.1.1 Check for the problem in the index under "problem" We have an extensive index at the end of this manual to help you when you have problems finding what you want to know. Please use it, especially if you do not read the manual from cover to cover. For example, you can find solutions to many common problems by looking up the keyword "problem" in the index. If you can not find something where you looked first in the index, let us know! We think the index should be comprehensive. That minimizes the number of calls we get asking about things which the manual fully explains but you can not find. 13.1.2 Check the compatibility lists 13.1.2 Check the compatibility lists Check the compatibility lists for an indication that we already know the problem which you have. The abbreviated manual on the distribution diskettes has the latest list. We may have already examined the circumstances and decided that we can do nothing about it without major changes. Or we may have indicated that we can do something about it and we are working on it already. At any rate, if you can find the problem mentioned in the compatibility lists the best we can recommend for now is: "Don't do that!". (C) Copyright 1984-86 Hersey Micro Consulting 13-1 (C) Copyright 1984-86 Hersey Micro Consulting 13-1 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations 13.1.3 Check for problems without FANSI-CONSOLE _____________ 13.1.3 Check for problems without FANSI-CONSOLE FANSI-CONSOLE _____________ Many problems reported as problems with FANSI-CONSOLE are not really FANSI-CONSOLE _____________ problems with FANSI-CONSOLE! Many people assume that if they have problems, it must be that new fangled thing they just installed. FANSI- ______ However, a simple test can sometimes tell you that it is not FANSI- CONSOLE FANSI-CONSOLE _______ _____________ CONSOLE. Simply uninstall FANSI-CONSOLE using the directions given in the chapter entitled "Starting Quickly". Instead, install the standard MS-DOS ANSI.SYS console driver. Then run the same programs you had problems with before. If they still have problems, then it FANSI-CONSOLE FANSI-CONSOLE _____________ _____________ can not be with FANSI-CONSOLE because FANSI-CONSOLE is not installed! FANSI-CONSOLE _____________ If you have no problems when you uninstall FANSI-CONSOLE, you are not done yet. It may surprise you to learn that! 13.1.4 Check for lack of memory problems 13.1.4 Check for lack of memory problems FANSI-CONSOLE _____________ Many problems reported with FANSI-CONSOLE are simply problems caused by not leaving enough memory for the application programs. SEE the subsection entitled "Leave enough memory for applications programs" in the chapter entitled "Starting Quickly". For more information FANSI-CONSOLE _____________ about the memory requirements of FANSI-CONSOLE, see the section FANSI-CONSOLE _____________ entitled "How much memory does FANSI-CONSOLE require?" in the chapter entitled "Detailed Installation". If you have a problem with an FANSI-CONSOLE _____________ application program when FANSI-CONSOLE is installed and you think it FANSI-CONSOLE _____________ was caused by FANSI-CONSOLE, there are several ways to check whether it is a "not enough memory" problem. One way to check whether it is a memory problem is to run the application program under the MS-DOS DEBUG program, which happens to FANSI-CONSOLE FANSI-CONSOLE _____________ _____________ be almost as big as FANSI-CONSOLE. Do this when FANSI-CONSOLE is still uninstalled after the last test. So about the same amount of memory remains for the application program. Just type "DEBUG <program.ext>" where <program.ext> is the application program file name, and then type "G" to get it going. When the application program finishes, type "Q" to quit DEBUG. If it does the same thing as when FANSI-CONSOLE _____________ FANSI-CONSOLE is installed, it is a "not enough memory" problem. FANSI-CONSOLE _____________ Since DEBUG is slightly smaller than FANSI-CONSOLE, if the application program still runs, this test does not say that there is enough memory! (C) Copyright 1984-86 Hersey Micro Consulting 13-2 (C) Copyright 1984-86 Hersey Micro Consulting 13-2 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations Another way to check whether it is a memory problem is to change the BUFFERS= line in the CONFIG.SYS file to use up an extra amount of FANSI-CONSOLE _____________ memory equal to the size of FANSI-CONSOLE. Since each buffer is about FANSI-CONSOLE _____________ 1/2 KB, you need to multiply the size of FANSI-CONSOLE in KB by 2, and add it to the BUFFERS= number that you used originally. There is a limit to the number of buffers you can specify, which depends on the MS-DOS version. You may not be able to set the number high enough FANSI-CONSOLE _____________ to use up the same amount of room as FANSI-CONSOLE if you used many buffers originally. If this is so, then at least try it with the maximum number of buffers you can specify. After changing the buffer count, you must then restart MS-DOS by pressing Alt-Ctrl-Del. Do this FANSI-CONSOLE _____________ when FANSI-CONSOLE is still uninstalled after the last test. So about the same amount of memory remains for the application program. If it FANSI-CONSOLE _____________ does the same thing as when FANSI-CONSOLE is installed, it is a "not enough memory" problem. Do not forget to change your buffer count back again after this test. Another check for "not enough memory" problems is to try setting your FANSI- ______ buffers count to a small number like 5, and re-installing FANSI- CONSOLE _______ CONSOLE, and then running your application program. If it runs correctly when the buffers count is small, the problem was a "not enough memory" problem. Do not forget to change your buffer count back again after this test. FANSI- ______ Another check for "not enough memory" problems is to install FANSI- CONSOLE _______ CONSOLE without allowing it any memory for the scroll recall feature. Then run your application program. If it runs correctly when you do not use scroll recall memory, the problem was a "not enough memory" problem. 13.1.5 Check for interaction problems 13.1.5 Check for interaction problems FANSI-CONSOLE _____________ Many problems reported with FANSI-CONSOLE are interactions between several products. The best way to check for an interaction with FANSI-CONSOLE _____________ FANSI-CONSOLE and other products is to start by renaming your AUTOEXEC.BAT file to something else like AUTOEXEC.OLD, and your FANSI-CONSOLE _____________ CONFIG.SYS to something like CONFIG.OLD. Then install FANSI-CONSOLE by itself, with no other resident programs loaded from CONFIG.SYS or AUTOEXEC.BAT. Check to see if the problem still appears with your FANSI-CONSOLE _____________ application program. If it does, then clearly FANSI-CONSOLE and your application program do not get along well, and you should report this to Hersey Micro Consulting, Inc. This assumes, of course, that the problem is not already mentioned in this manual! Telling us what we already know does not help us fix it faster. (C) Copyright 1984-86 Hersey Micro Consulting 13-3 (C) Copyright 1984-86 Hersey Micro Consulting 13-3 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations If the problem does not appear, then you may have some type of FANSI-CONSOLE _____________ interaction problem with FANSI-CONSOLE and something being loaded in CONFIG.SYS or AUTOEXEC.BAT. The next step is to find out which programs are interacting. You do this by adding the old lines back to the new CONFIG.SYS file one line at a time. Then, after you add each line, do an Alt-Ctrl-Del and test for the problem once again. Then do the same to the new AUTOEXEC.BAT file. When the problem reappears, the last line added to CONFIG.SYS or AUTOEXEC.BAT indicates the most likely culprit. To double check, remove everything else except the FANSI-CONSOLE _____________ last line and the DEVICE= line for FANSI-CONSOLE from CONFIG.SYS and AUTOEXEC.BAT and test for the problem again. If the problem appears FANSI-CONSOLE _____________ again, then you know which program FANSI-CONSOLE is interacting with, and you should report this to Hersey Micro Consulting, Inc. FANSI-CONSOLE _____________ If the problem fails to reappear with just FANSI-CONSOLE and the other culprit installed, you probably have a complicated interaction problem. At the least, you should try to remove as many resident programs as possible from the CONFIG.SYS and AUTOEXEC.BAT while still being able to reproduce the problem. This eliminates at least some programs you use from the list of possible causes. Many device driver manuals indicate that the device driver must be loaded before any other device drivers. This is not always true. Typically, there are some ordering requirements. If the problem is FANSI-CONSOLE _____________ because of an interaction between FANSI-CONSOLE and another device driver loaded in the CONFIG.SYS file, then try changing the order in which you load the two drivers. Frequently, when one order causes a problem, the other order does not. 13.1.6 When all else fails....give us a call 13.1.6 When all else fails....give us a call When all else fails, give us a call or write us a letter. When you do call us, we highly suggest that you have both the user manual, and your computer sitting in front of you. We suggest that you use the forms found at the end of this manual to determine what information we may need to find the cause, before you call or when you write. We also suggest that you check the section below entitled "How do I help you solve compatibility problems?" for details about how to collect information for us which may be useful in solving the problem. You might try using our bulletin board system to see if we describe your problem and a solution there. To use our bulletin board system, dial (313) 994-3946 (24 HRS). It supports both 300 and 1200 BPS, No parity, 8 bit bytes, 1 stop bit. After getting a carrier, press return several times, until you get a prompt. From then on, the on- line help should explain how to proceed if you do not already know. (C) Copyright 1984-86 Hersey Micro Consulting 13-4 (C) Copyright 1984-86 Hersey Micro Consulting 13-4 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations 13.2 What limitations does FANSI-CONSOLE have? _____________ 13.2 What limitations does FANSI-CONSOLE have? FANSI-CONSOLE _____________ FANSI-CONSOLE does have some limitations and we hope to remedy these in the future. FANSI-CONSOLE _____________ FANSI-CONSOLE could easily be made to accept more of the ANSI standard escape sequences. We will try to extend it. FANSI-CONSOLE _____________ FANSI-CONSOLE may not work with some keyboard macro programs. Because the type ahead buffer is bigger, it must be handled slightly differently. We will try to make it work with most of these programs, and try to eliminate the need for separate keyboard macro programs, FANSI-CONSOLE _____________ by adding functions to FANSI-CONSOLE, or to a companion program. FANSI-CONSOLE _____________ FANSI-CONSOLE may not work with newer IBM or newer so called compatible graphics adapters. We will either make separate versions or have appropriate switches. (C) Copyright 1984-86 Hersey Micro Consulting 13-5 (C) Copyright 1984-86 Hersey Micro Consulting 13-5 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations 13.3 Are there several versions of FANSI-CONSOLE? _____________ 13.3 Are there several versions of FANSI-CONSOLE? FANSI-CONSOLE _____________ FANSI-CONSOLE currently has only one current version which works for all the kinds of IBM-PC compatible computers that it supports. However, in the future we may produce different versions for different kinds of computers or for different kinds of display serial ______ adapters. The first character of the serial (not the version) number indicates the type of computer which a version is meant to run on: 0 IBM-PC and very compatibles with very compatible ROM BIOS. This includes the IBM-PC AT and compatibles. The ROM BIOS must have console variables in the same place as the IBM-PC. The display adapters must be compatible with the IBM CGA, IBM MDPA, or IBM EGA. (C) Copyright 1984-86 Hersey Micro Consulting 13-6 (C) Copyright 1984-86 Hersey Micro Consulting 13-6 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations 13.4 What programs are compatible with FANSI-CONSOLE? _____________ 13.4 What programs are compatible with FANSI-CONSOLE? Any program which only uses MS-DOS or ROM BIOS screen and keyboard FANSI-CONSOLE _____________ calls should work with FANSI-CONSOLE, and have faster screen painting. Any compiler or assembler should work. Programs which use standard language calls for reading and writing the console should have faster screen painting. Only programs that manipulate hardware address contents or BIOS variables directly may not run correctly FANSI-CONSOLE _____________ with FANSI-CONSOLE. Note that most of the information here was given to us by our customers. Although we are careful about what we place in these lists, we cannot possibly verify all this information, so we can not and do not guarantee the accuracy of this list. The indication "(faster)" in the list below means that the program's screen writing FANSI-CONSOLE _____________ is noticeably faster using FANSI-CONSOLE than without using it, or, for compilers, that programs written in the language have faster screen writing. Other programs listed which work at the same speed as they would otherwise are indicated as "(not faster)". Lastly, many programs have only been reported as compatible but no indication was made about whether they are faster. Let us know when you find a program which is faster, but is not listed here as being faster. The indication such as "(/Y=1)" means that the program must be run FANSI-CONSOLE _____________ with the FANSI-CONSOLE option indicated. FANSI-CONSOLE _____________ The indication "(no VT100)" means that FANSI-CONSOLE does not add VT100 capabilities to the indicated communications program. This is true for many but not all communications programs. FANSI-CONSOLE _____________ Note that compatibility means that FANSI-CONSOLE does not interfere with the proper program operation with correct configuration of both programs. The opposite may not be true. Some programs may interfere FANSI-CONSOLE _____________ with some features of FANSI-CONSOLE, as indicated. (C) Copyright 1984-86 Hersey Micro Consulting 13-7 (C) Copyright 1984-86 Hersey Micro Consulting 13-7 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations FANSI-CONSOLE _____________ This list of programs we believe are compatible with FANSI-CONSOLE is not all inclusive by any means! (Names below are all trademarks of indicated companies) ABC - Consortium Software, UofM Acceler8/16 - (faster) AE Pro - ANSI.SYS - (programs which use it) (faster) APL - STSC, Inc. AST 5250 Emulation - (/S=0) AutoCad - Autodesk (/S messes up graphics) (faster) BACKSCRL.COM (/R=0) (faster) Benchmark - Metasoft Bernoulli Box - Iomega (Must rename FCONSOLE.DEV to ANSI.SYS!) Best Friend - Elite Software Bridge Utilities - Bridge Software Brief - Underware (w/EGA&EGD, try -p instead of -e for 43 lines) C86 C compiler - Computer Innovations, all versions (faster) CED (Command EDitor) - Cove Software (/Q=0 in some cases) Central Point Option Board - Central Point Software CGCLOCK - Chart-Master 6.03 - Decision Resources (faster) Clipper - (/Q=0) Color Magic - Brightbill-Roberts Condor - Condor Computer (faster) Cornerstone - Infocom (faster) Crosstalk - Microstuf (no VT100) DAED - (/Q=0) DataBase Manager II - Alpha Software DataEasy - Data Consulting Group DBase II - Ashton-Tate (/Y=1) (faster, no more type ahead) DBase III, DBase III Plus - Ashton-Tate (not faster, no more type ahead) DeskMate - Alternate Decision Software Desmet C - (/Q=0 w/SEE) Diskette Manager - Lassen Software DESQ - Quarterdeck Office Systems Desqview - Quarterdeck Office Systems (faster) (use /T=1 to use escape sequences) Directory Scanner - DOS Command Retriever - IBM (/Y=1) DOSEDIT - Gersbach, Jack (/Y=1) DOSVIEW Utilities - Lightning Software Easy - MicroPro (no FANSI-KEYRATE) Easy Business Systems - Sorcim (faster) EasyWriter I - Sorcim/IBM (faster) EasyWriter II - Sorcim (not faster) Edix - Emerging Technologies (faster) Ellar - Ram Disk (C) Copyright 1984-86 Hersey Micro Consulting 13-8 (C) Copyright 1984-86 Hersey Micro Consulting 13-8 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations EM100 - Diversified Computer Systems Ener-Graphics - (faster) Enhanced Debugger - IBM FarSight - FANSI-RAMDISK _____________ FANSI-RAMDISK - Hersey Micro Consulting File Command II, III - IBM FileView - IBM Final Word - Mark of the Unicorn, MS-DOS version (faster) FlashCode - FlickerFree - Gibson (But there's no advantage to using them both!) forMath - Shantha Software Forte 3270 Board - Framework - Ashton-Tate (not faster) Friday - Ashton-Tate (faster) Grammatik - Digital Marketing Software Graphwriter 4.3 - Graphic Communications GWBasic - Microsoft (/Y=1) (faster) HardRunner - Nostradamus Harvard Project Manager - Harvard Software Hockney's Egg - Peregrin Falcon Co. IBM Basic, all versions (faster) IBM Fixed Disk Organizer (/S=0) IBM-PC DOS 2.00 (faster) IBM-PC DOS 2.10 (faster) IBM-PC DOS 3.00 (faster) IBM-PC DOS 3.10 (faster) IBM-PC DOS 3.20 (faster) (Not well enough tested yet) IBM Personal Editor IBM 5250 Emulator (but scroll recall locks) Impersonator - Direct Aid Inc. Intracourse - IUS - Accounting Series - General Ledger (faster) JBoot - Tall Tree Systems FANSI-CONSOLE _____________ (load after FANSI-CONSOLE and be sure the read/write memory test only tests memory after where JBoot is loaded by using the JBOOT option /X=nB. Otherwise JBOOT self destructs because of a JBOOT programming error). JDrive - Tall Tree Systems JSpool - Tall Tree Systems JPager - Tall Tree Systems Kedit - Mansfield Software Kermit - Columbia University (faster,VT100) Keyworks - Alpha Software Knowledge Man - Micro Data Base Systems, Inc. (/Q=0) Lattice - C compiler, all versions Leading Edge Word Processor (LEWP) - Leading Edge Le Print - LeBaugh Software Lightning - LIST - LOGO - IBM (requires LOGO.PCH) (C) Copyright 1984-86 Hersey Micro Consulting 13-9 (C) Copyright 1984-86 Hersey Micro Consulting 13-9 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations LOOK - Lotus 1-2-3 - Lotus (not faster) (/S messes up graphics) Managing Your Money - Meca Software Max Think - MaxThink, Inc. The MBA Accountant - Micro Business Applications (faster) Microsoft Assembler Microsoft C compiler (faster) Microsoft Mouses (meese?) (/Y=1) FANSI-CONSOLE _____________ Must load FANSI-CONSOLE before mouse driver. Microsoft Multiplan MS-DOS version (faster) Microsoft Pascal Compiler (faster) Microsoft Project Microsoft Quick Basic Microsoft Windows (use Num/Cap/Scr to turn screen back on) Microsoft Word 1.1,2.0 (not faster) (macros will not always work properly) Micro Tex - Addison Wesley MiniLedger - Paradigm Consultants (faster) MODEM86 _______ MODEM86 - Hersey Micro Consulting (faster,VT100) Modula II - Logitech Monografx - Analytics MORERAM - Mouse Systems - PC Mouse FANSI-CONSOLE _____________ Must load FANSI-CONSOLE before mouse driver. MultiHalo - Multimate Word Processor - Multimate International (not faster) Multi-OS - Davong (faster) NewKey - FAB Software (Frank Bell) Norton Commander - Norton Norton Editor - Norton Norton Utilities 2.0 (faster) Norton Utilities 3.0 (faster if not direct I/O) Note-It - Novell Netware - Novell Nu-Epson - PBS - Personal Bibliographic Software PC Accelerator 3.0 - (Use DEVICE=PCA /K in CONFIG.SYS before FANSI-CONSOLE _____________ FANSI-CONSOLE. Use PCU /K in AUTOEXEC.BAT or "disable keyboard command" option in install program) PC-Calc - Buttonware PC/Cutlisting (faster) PC-Deskmates - PC-Draw - Micrografx, Inc. (faster) PCED (Professional Command EDitor) - Cove Software PC-FILE - Buttonware PC/InterComm - Mark of the Unicorn (no screen save) PC Paint - Mouse Systems (not faster) PC Paintbrush - Zsoft Corp (C) Copyright 1984-86 Hersey Micro Consulting 13-10 (C) Copyright 1984-86 Hersey Micro Consulting 13-10 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations PCPedal - PC Script - IBM PC Storyboard - IBM PC-TALK - Headlands Press (faster, no VT100) PC/VI - Custom Software Systems (faster) PC Watch - IBM PC-Write - Quicksoft (/Q=0) P-Edit - Satellite Software International Personal Rex - Mansfield Software (faster) pfsFILE - Software Publishing Corp. pfsREPORT - Software Publishing Corp. pfsWRITE - Software Publishing Corp. Pinball Construction Set - Software Arts Polaroid - Palette (/S messes up graphics) PolyForth II - Forth, Inc. (faster) PolyWindows Plus - Polytron Pop-Up Deskset - Popular Programs Printshop - Borderbund ProCite - Personal Bibliographic Services Procom - PIL Software Systems Prokey - RoseSoft (except LAYOUT program) (must use PROKEY /T0) Pro-Yam - (faster,VT100) P.S. Technical Word Processor - Scroll Systems, Inc. (not faster) QDOS - Gazelle Systems (/Q=0) QMODEM - John Friel (faster,VT100) QM2 - QuadRam Quick Check Money Manager - Chuck Atkinson Programs RBase - MicroRim (faster) Ready! - Living Videotext, Inc. Relay - VM Personal Computing (not faster) (no VT100) Reflex - Borland Referee - Persoft RESET.COM - Apparat Revelation - Cosmos Rightwriter - Decisionware RP/M2 - (faster) SAMNA Word - SAMNA Corporation (faster) Savvy PC - Excalibur Technologies Corp. Sidekick - Borland International (not faster) SmartCom II - Hayes (no VT100, not faster) (must set FANSI-SCRNTIME = 0) SmartKey - Software Research Technology SmartNotes - SmartStuff - The Smart System - (/Q=0) Softkey - Software Carousel (1.5C) - SoftLogic Solutions SQZ! - Star Accounting - Star Software Systems (faster) SuperCalc 3.2 - Sorcim (not faster) SuperDrive - AST SuperKey - Borland (C) Copyright 1984-86 Hersey Micro Consulting 13-11 (C) Copyright 1984-86 Hersey Micro Consulting 13-11 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations FANSI-CONSOLE _____________ All FANSI-CONSOLE functions except VT100 keys, BIOS level key macros, and local mode work correctly. All SuperKey functions work correctly. SuperSpool - AST SuperWriter - Sorcim (not faster) Symphony - Lotus Development Corp. (not faster) Take Two Tall Screen - Qualitas (use /R=0) Teleterm - Tandy (faster) Textra - Ann Arbor Software (not faster) ThinkTank - Living Videotext, Inc. TMS Fastware - Thesys TopView - IBM Tornado Notes - TSR - Turbo Lightning - Borland Turbo Pascal - Borland Turbo Tax - Chipsoft TymComm - Tymshare Ultra Utilities - UTIL - Vedit - CompuView - IBM-PC version (/Q=0, some things faster) Vedit - CompuView - MS-DOS version (faster) Versa Cad 4.0 - T & W Systems (not faster) Versaform XL - Applied Software Technology (faster) VidTex - CompuServe Volkswriter - Lifetree Software (not faster) VP Planner - WatCom - GML Window - University of Michigan WindowDOS - Windows - Microsoft (not faster) (for /S use one of NUM/CAPS/SCR keys) Windows for C - Wishbringer - Infocom WordFinder - Word Perfect - Satellite Software International (faster) Word Perfect Library - Satellite Software International Word Perfect MathPlan - Satellite Software International Word Perfect SSIDate - Satellite Software International WordProof - IBM (faster) Wordstar - MicroPro, IBM-PC version (/Q=0, faster) Wordstar 2000 - MicroPro (/Q=0) Xtree - Executive Systems XyWrite III (not II!)- XyQuest (/C=0) (cannot effect key repeat without XYKBD) (cannot use scroll recall with XYKBD) (C) Copyright 1984-86 Hersey Micro Consulting 13-12 (C) Copyright 1984-86 Hersey Micro Consulting 13-12 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations 13.5 What computers are compatible with FANSI-CONSOLE? _____________ 13.5 What computers are compatible with FANSI-CONSOLE? This list of computers and display adapters we believe are compatible FANSI-CONSOLE _____________ with FANSI-CONSOLE is not all inclusive by any means! We give our FANSI-CONSOLE _____________ suggestions for appropriate FANSI-CONSOLE parameter options in parentheses when they differ from the defaults. If /H=1 is specified, this means that the defaults are appropriate. No suggestion means that you have to find out for yourself what is best, although it is likely to be the defaults. Let us know when you find out! Note that we base our recommendations on not adding additional drawbacks over the standard BIOS code to gain speed. You may find some drawbacks more acceptable than we do. So you may find different settings more to your liking because it is faster even though there are drawbacks. See the chapter entitled "Detailed Installation". The notation "50 lines" means that you can use a 50 line mode with the display adapter. The notation "43 lines" means that you can use a 43 line mode with the display adapter. Note that an appropriate display is always required for no wavering. No notation means we do not know enough about the display adapter capabilities. Note that only a few adapters have 132 column capability! None of the IBM cards have it! Unless the adapter manual describes it, you do not have it. Note that often the proper setting specified here is the same as the default. If /D=0 is specified, means that /D=1, FANSI-DBLSCAN, and FANSI-DBLROWS do not function on this adapter (so you cannot use 50 line mode). (Names below are all trademarks of indicated companies) Amdek - MAI (/H=0) American Research Corp (A.R.C) - PC Turbo (/X=7) Arrow - XT AST - MonoGraphPlus AT&T - 6300 (/X=3 V1.09 implies /H=1/B=0/W=1) (Also try adding /B=1, blinks when scrolling, but it is much faster) (no super high resolution mode yet) - 6300 PLUS (/X=3 V1.09 implies /H=1/B=0/W=1) (Also try adding /B=1, blinks when scrolling, but it is much faster) Bronson - Innovation Color Graphics/Printer Adapter Columbia Data Products - Multi Personal Computer Compaq - Compaq (/H=0/B=1/W=0) - Compaq Plus (/H=0/B=1/W=0) - Compaq Deskpro (/H=0/B=1/W=1) - Compaq Deskpro 286 (/H=0/B=1/W=1, 50 lines) Conographics - Conocolor 40 Corona - Desktop - (/H=1/B=1/W=0) - Portable - (/H=1/B=1/W=0) - PPC-400-XT w/super res graphics (C) Copyright 1984-86 Hersey Micro Consulting 13-13 (C) Copyright 1984-86 Hersey Micro Consulting 13-13 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations (no extra mode support!) Data General - One (/X=5 V1.12 implies /H=0/B=0/W=0) (has no video disable) (Some problems with mode changes) Eagle Computers - Color/Graphics Adapter - PC-2 (84 key model only) (use IBM DOS because of Eagle DOS bugs) - PC Turbo (84 key model only) - Spirit XL Epson - Equity 1 - Equity 2 - Equity 3 Everex - Evercolor - Graphics Edge (132 column support) Suggest use J1=J3=OFF, and /H=0/B=0, although it causes black snow. FANSI-CONSOLE _____________ J2 irrelevant for FANSI-CONSOLE. - Edge (/S=0 in color mode, even with /B=0) (132 column support) - Graphics Pacer Genoa - Spectrum (/H=0, 132 column support) Goupil - G4 (/X=2 V1.02, implies /H=1/B=1/W=0) Hercules - Monochrome Graphics Adapter (yes, /S is OK!) (no support for graphics modes or second page) - Color Adapter (/H=1/B=1, 50 lines) Hewlett-Packard - Vectra IBM - PC, 64 KB motherboard (/W=0) - PC, 256 KB motherboard (/W=0) - PC/XT (/W=0) - Portable PC (/W=0) - PC/AT (/W=1) - Monochrome Display Adapter (MDA) (/H=1/B=1,no 50 lines) - Color Graphics Adapter (CGA) (/H=1/B=1) - Enhanced Graphics Adapter (EGA) (automatic /H=0/B=1 V1.13, 43 lines) - Professional Graphics Adapter (PGA) (only in CGA emulation mode) Innovation - Product #1007 ITT - PC (w/version 2.00 ROMs) - Xtra Kaypro - 2000 - 286i Leading Edge - Model D (/H=0/B=1/W=0) - Model M MA Systems - PC Peacock Mad Computer - Mad-1 (/X=2 V1.02, implies /H=1/B=1/W=0) MicroGraphics Technology - MasterGraphics I Adapter Mylex - Chairman graphics board NCR - PC4 - PC6 (C) Copyright 1984-86 Hersey Micro Consulting 13-14 (C) Copyright 1984-86 Hersey Micro Consulting 13-14 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations - PC8 NSI - EPIC Graphics Adapter Olivetti - M24 (/X=3 implies /H=1/B=0/W=1) (Also try adding /B=1, blinks when scrolling, but it is much faster) Panasonic - Sr. Partner Paradise - Modular Graphics adapter (/H=0/B=0) - Multi Display adapter (/H=0/B=0) PCs Limited - PC Turbo (/X=7) - AT Turbo (/W=1) Persyst - BoB Color Adapter (/H=0/B=0/Z=012) - Monochrome Board Plantronics - ColorPlus (/H=1/B=1) Profit Systems - Multigraph color adapter Quadram - QuadColor I & II (/H=0/D=0) (Background color remains in screen save) - QuadEGA+ Graphics Adapter (automatic /H=0/B=1 V1.13, 43 lines) - QuadSprint (faster) Seequa - Chameleon Sigma Designs - Color 400 Color Adapter Everything works except the utility software that comes with the board. No support for extra modes. Sperry - Sperry PC (/H=1/B=1) - Sperry IT (AT /W=1) STB - Graphix Plus II - Monochrome Tandy - Tandy 1000 (/X=4 V1.10 implies /H=0/B=1/W=0) - Tandy 1200 - Tandy 3000 (AT /W=1) Tecmar - Graphics Master (/H=0/B=1, 50 lines) Televideo - TeleCat Tseng Laboratories - UltraPak Board Video 7 - VEGA (automatic /H=0/B=1 V1.13, 43 lines) Xerox - 6065 (/X=3 V1.09 implies /H=1/B=0/W=1) (Also try adding /B=1, blinks when scrolling, but it is much faster) Zenith - Z150,Z160,Z138,Z148 series (/X=1 V1.01 implies /H=0/B=1/W=0, 50 lines in some models) - Z200 series (/W=1) (C) Copyright 1984-86 Hersey Micro Consulting 13-15 (C) Copyright 1984-86 Hersey Micro Consulting 13-15 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations 13.6 What programs are incompatible with FANSI-CONSOLE? __ _____________ 13.6 What programs are incompatible with FANSI-CONSOLE? The following are some areas of expected incompatibility problems: 1. Programs which replace the keyboard interrupt vectors may cause FANSI-CONSOLE _____________ some difficulty for FANSI-CONSOLE or vice versa. This is not true of most of them, though. 2. Programs which try to insert characters into the keyboard type FANSI-CONSOLE _____________ ahead buffer may not work with FANSI-CONSOLE. This is not true of most of them, though. 3. Some programs that manipulate BIOS variables directly. This is not true of most of them, though. 4. MS-DOS versions earlier than MS-DOS 2.00 do not have a standard mechanism for installing loadable device drivers. In general, other application packages should instead be upgraded to work with the current version of MS-DOS (even if not to use new MS- DOS features). In most cases, other application products need no upgrading to work under the current MS-DOS version. In other cases, the upgrade should be purchasable for a small price. 5. Some programs that run from an AUTOEXEC.BAT file and which cause the MS-DOS to redo part of the bootstrap process after FANSI-CONSOLE _____________ FANSI-CONSOLE initializes. This is because they reuse the FANSI-CONSOLE _____________ memory that FANSI-CONSOLE resides in when it is active and processing timer interrupts. Such programs should be made into device drivers and placed first in the CONFIG.SYS file, or be made to use INT 19. 6. Programs which do not work properly with the IBM-PC ANSI.SYS driver. Most of these kinds of programs work for the most part, but some characters used in display messages are ANSI X3.64 control characters and therefore do not get displayed. 7. Programs which expect all MS-DOS console reading and writing to eventually be done through the ROM BIOS, instead of directly by the MS-DOS console driver. This is a bad assumption on their FANSI-CONSOLE _____________ part, and cannot be cured by changing FANSI-CONSOLE. 8. Programs which change the screen display mode themselves without calling the BIOS to do it, and then call the BIOS to display characters on the screen. This is a bad practice on FANSI-CONSOLE _____________ their part, and cannot be cured by changing FANSI-CONSOLE. (C) Copyright 1984-86 Hersey Micro Consulting 13-16 (C) Copyright 1984-86 Hersey Micro Consulting 13-16 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations Please tell us about these programs so we may either find a solution for you and others in the same predicament or at least give a more specific warning. Since we may be able to solve the problem, programs may move from this list to the one above. Sometimes we leave them in this list, but give a patch which makes specific programs FANSI-CONSOLE _____________ versions below work with FANSI-CONSOLE. (C) Copyright 1984-86 Hersey Micro Consulting 13-17 (C) Copyright 1984-86 Hersey Micro Consulting 13-17 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations FANSI-CONSOLE _____________ This list of programs we believe are incompatible with FANSI-CONSOLE is not all inclusive by any means! FANSI-CONSOLE _____________ Programs we believe are NOT compatible with FANSI-CONSOLE: (Names below are all trademarks of indicated companies) Accelerator PC - Swifte APX Core Executive - Application Executive Corporation Expects MS-DOS console writing to all go through the ROM BIOS. DiskCat - Nelson Ford Crashes. Double Dos - SoftLogic Solutions Expects MS-DOS console writing to all go through the ROM BIOS. DR-Draw - Digital Research Crashes immediately. Easy-DOS-It - BMS Computer Flight Simulator - Microsoft FS program does not work. Must boot diskette instead. IBM-PC DOS 1.0 - Does not allow loadable device drivers. IBM-PC DOS 1.1 - Does not allow loadable device drivers. KeyNote - KEYBFR, KEYBGR, KEYBIT, KEYBSP, KEYBUK - IBM PC DOS FANSI-CONSOLE _____________ Replaces FANSI-CONSOLE keyboard vectors causing extra functions to be unavailable. Memory/Shift - North American Business Systems, Inc. Expects MS-DOS console writing to all go through the ROM BIOS. Does not look serious. MultiLink - Software Link Expects MS-DOS console writing to all go through the ROM BIOS. NoBlink - Nostradamus Expects MS-DOS console writing to all go through the ROM BIOS. Re-Call - YES software. FANSI-CONSOLE _____________ Breaks many FANSI-CONSOLE features. REMIND - Causes "missed characters". Savvy PC - Excalibur Technologies Corp. Immediate system failure when run. Say What?! - (Must use our POP.COM on BBS) Does not work with all programs that it normally works with. SCRLLOCK - Same functions already in FANSI-CONSOLE _____________ FANSI-CONSOLE. SCRNSAVE - Same functions already in FANSI-CONSOLE _____________ FANSI-CONSOLE. (C) Copyright 1984-86 Hersey Micro Consulting 13-18 (C) Copyright 1984-86 Hersey Micro Consulting 13-18 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations Seasoned Systems - Dvorak keyboard program. Same functions already in FANSI-CONSOLE _____________ FANSI-CONSOLE. SP - Print Spooler - Alan Jones. Program performs poor check for itself already loaded. SpeedKey - Public Domain Same functions already in FANSI-CONSOLE _____________ FANSI-CONSOLE. Universe - Omnitrend "Gets confused". Visage Laser Disk - System failure immediately. Xywrite II - Reported that it only works when BREAK=OFF. Not well investigated yet. (C) Copyright 1984-86 Hersey Micro Consulting 13-19 (C) Copyright 1984-86 Hersey Micro Consulting 13-19 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations 13.7 What computers are incompatible with FANSI-CONSOLE? __ _____________ 13.7 What computers are incompatible with FANSI-CONSOLE? For some computers, there are currently some general problems we know which may prevent portability to computers other than IBM-PC's. FANSI-CONSOLE _____________ 1. FANSI-CONSOLE always resides in memory. Although it is not a big program, it may be big enough to cause problems on a small computer (192 KB or less) with at least some other application programs not having enough remaining memory. Also using other memory resident programs, even on larger computers, may cause memory space problems, but these are often solvable. Such memory resident programs include ram-disks and print spoolers. One simple solution for problems related to these programs is to reduce their memory usage a bit. Of course, you can usually eliminate the problem by buying more memory for your computer. In these cases, just one bank of 64 KB is much more than enough. 2. The location of keyboard ROM BIOS variables must be the same as FANSI-CONSOLE _____________ the IBM-PC's for FANSI-CONSOLE to support some fancier FANSI- ______ keyboard macro programs. We will have a version of FANSI- CONSOLE _______ CONSOLE for computers with slightly less compatible ROM Bioses. 3. The location of the lower half of the font table for the graphics modes depends upon your BIOS ROM. This address is set by the "/F=" option on the device specification line in CONFIG.SYS. 4. Instructions necessary to prevent the soft restart (Alt-Ctrl- Del) from doing the complete power up self tests differ on different computers. Those necessary on the IBM-PC may be dangerous on other computers. We are investigating possible solutions to this. 5. The computer may not be completely hardware equivalent with the IBM-PC. If the computer's equivalence is only at the ROM BIOS FANSI-CONSOLE FANSI- _____________ ______ level, then FANSI-CONSOLE will not work. For example, FANSI- CONSOLE _______ CONSOLE definitely does not work on any MS-DOS computer with a console terminal connected to the computer via a serial port. The only solution to this type of problem is a completely FANSI-CONSOLE _____________ different version of FANSI-CONSOLE for each of these kinds of computers, which will not happen too quickly. (C) Copyright 1984-86 Hersey Micro Consulting 13-20 (C) Copyright 1984-86 Hersey Micro Consulting 13-20 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations This list of computers and display adapters we believe are FANSI-CONSOLE _____________ incompatible with FANSI-CONSOLE is not all inclusive by any means! Computers and display adapters we believe are NOT completely FANSI-CONSOLE _____________ compatible with FANSI-CONSOLE: (Names below are all trademarks of indicated companies) Control Systems - Artist - 7220 Chip DEC - Rainbow - Not a hardware compatible computer. The computer does have enough similarities that it may be worthwhile for us to FANSI-CONSOLE _____________ make a version of FANSI-CONSOLE for it. It would turn it into a more compatible computer. Eagle with 105 key keyboard - Reported to work but there are extra unsupported keys. We do not have enough documentation about them yet. Epson QX-10 w/Titan PC emulator- Might work, but doubtful. We do not have enough documentation about them yet. ERSO BIOS - hangs at boot up. Everex - The Ace - 7220 Chip Fast88 - Just locks up. Frontier Technologies - Business Graphics Board 7220 Chip - Intelligent High Resolution Graphics 7220 Chip Quadram - QuadVue Not a hardware equivalent to MDPA. IBM - PC jr. - Trouble changing screen modes. However, we may create a version for this computer. IBM - 3270 PC - Not hardware equivalent to standard PC video adapters. IDEAssociates - IDEAgraph Color Graphics adapter - 7220 Chip Matrivision - Matrigraph - 7220 Chip NEC APC II- (Not the same as III) Same problem as DEC Rainbow. Number None - Revolution Graphics Board - 82720 Chip Orchid Turbo 186 board - not PC equivalent. (C) Copyright 1984-86 Hersey Micro Consulting 13-21 (C) Copyright 1984-86 Hersey Micro Consulting 13-21 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations Quadram - DataView Keyboard does not have hardware debouncing. Keys come out duplicated. Sanyo - Sanyo 550 - Both with and without the "PC compatible" video board: Same problem as DEC Rainbow. Video board is not enough because the keyboard still works differently. Sigma Designs - Graphics Dazzler I & II - 7220 Chip Sperry - Hi-Res Graphics Adapter Scan lines missing at bottom of character. Tandy 2000 - Same problem as DEC Rainbow. Tava - PC - Works for the most part, but on the computer we tried, Ctrl-Alt-Del puts the computer in an infinite loop. Solution seems possible. Texas Instruments - Professional Computer - Same problem as DEC Rainbow. Wang PC w/o/PC display adapter - Same problem as DEC Rainbow. Wang PC w/PC display adapter - Might work, but doubtful. We do not have enough documentation about them yet. Zenith Z100 - Same problem as DEC Rainbow. (C) Copyright 1984-86 Hersey Micro Consulting 13-22 (C) Copyright 1984-86 Hersey Micro Consulting 13-22 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations 13.8 How do I help you solve compatibility problems? 13.8 How do I help you solve compatibility problems? Generally, for us to solve compatibility problems, we need to know what the other program does. We obviously can not afford to buy FANSI-CONSOLE _____________ copies of all programs just to test them with FANSI-CONSOLE. However, we do need to find out what they do. Depending on how the program does things, and what type of symptom you experience, there may be a general method for you to gather information for us. 13.8.1 How to use redirection 13.8.1 How to use redirection If your program uses MS-DOS calls for screen writing, and the problem just had to do with the way things display on the screen, then you can redirect its screen writing to a file. Simply add >B:RECORD.RDC ">B:RECORD.RDC", for example, to the normal MS-DOS command that you use to run the program, to redirect the screen writing to the file B:RECORD.RDC. If the program uses MS-DOS calls for screen writing, then there is no screen writing. Instead all the screen writing goes into B:RECORD.RDC. If the screen is really written to, then the program either uses BIOS calls or uses direct hardware manipulation. Now you need to use the same input that you normally use when running the program, to generate the same results which caused problems. When the screen writing is redirected, it is difficult, of course, because you can not see the results of what you do on the screen. It may pay to practice without the screen writing redirected, and record what you typed. After you finish, you may TYPE B:RECORD.RDC to see what would have been displayed on the screen. It goes by pretty quickly, though. Now that you have the record in B:RECORD.RDC, you should send us a copy of it along with a problem description, so that we may determine what happened. (C) Copyright 1984-86 Hersey Micro Consulting 13-23 (C) Copyright 1984-86 Hersey Micro Consulting 13-23 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations 13.8.2 How to use TRAP 13.8.2 How to use TRAP Occasionally there may be a need to report a problem with a program which uses BIOS calls to do its screen writing. A program uses BIOS calls if you can not redirect the screen writing. We may find out what they do if you help us by running TRAP. This may help with those problems where the screen writing is displayed incorrectly or the program suddenly locks up when you start it or when you press a certain key at a certain time. TRAP takes two parameters. The first parameter is the name of a file to keep trapped information. The second parameter is the hex value of which interrupt vector to trap. Normally, the interrupt vector trapped is interrupt 10. A typical TRAP call looks like this: TRAP B:RECORD.TRP 10 TRAP B:RECORD.TRP 10 This MS-DOS command causes TRAP to run and remain resident. It traps all calls to interrupt vector 10, the video interrupt vector, and records the values in the registers at that time. The record is kept in the file B:RECORD.TRP. FANSI-CONSOLE _____________ Once you have found a program for which FANSI-CONSOLE does not process video interrupts calls correctly, install TRAP and then rerun the program. Note that when TRAP is installed, programs which use BIOS video calls run much more slowly, because of the writing to B:RECORD.TRP. After the problem reoccurs, you should restart your computer using Alt-Ctrl-Del. This is because you do not normally want to have TRAP installed and slowing things down. Now that you have the record in B:RECORD.TRP, you should send us a copy of it along with a problem description, so that we may determine what happened. FANSI-CONSOLE _____________ TRAP will only trap interrupt 10 correctly if FANSI-CONSOLE is installed and the /R option is non-zero. Otherwise, it causes an infinite loop because it calls the MS-DOS to write out file records during the original MS-DOS call to write out characters to the screen. MS-DOS does not allow this. Other interrupts used by the MS- DOS have similar problems when trapped using TRAP. (C) Copyright 1984-86 Hersey Micro Consulting 13-24 (C) Copyright 1984-86 Hersey Micro Consulting 13-24 FANSI-CONSOLE Compatibility and Limitations _____________ FANSI-CONSOLE Compatibility and Limitations 13.8.3 How to use WATZITBE and WATZITDO 13.8.3 How to use WATZITBE and WATZITDO If you have a PC clone and the keyboard gives you problems when FANSI-CONSOLE _____________ FANSI-CONSOLE is installed, because it ignores some keys or treats them differently than you expect, then you may find a use for WATZITBE and WATZITDO. WATZITBE displays what scan codes the keys generate when you press them. This identifies numerically which key is which. WATZITDO displays what keys do when you press them. This means which characters the BIOS queues, and which shifts or locks the BIOS changes. Generally, the purpose of WATZITBE and WATZITDO is to find out how your computer differs from the standard. After running WATZITBE, it displays several lines every time you press a key, indicating which scan codes the keyboard generates for that key. Normally there is one for pressing the key and one for releasing the key. If the key repeats, the keyboard repeats the first scan code. To exit WATZITBE when you finish, you need to press Alt- Ctrl-Left-Shift-Right-Shift. You must have them all pressed down at the same time. After running WATZITDO, it displays a line every time you press a key, indicating whether it generated a key code, or how it changed the shift or lock status bits. To exit WATZITDO when you finish, you need to press Alt-Ctrl-Left-Shift-Right-Shift. You must have them all pressed down at the same time. Generally, the best approach to take is to run WATZITBE once to get the scan numbers for each key. Then run WATZITDO twice. The first FANSI-CONSOLE _____________ time, run it without FANSI-CONSOLE installed. This is to find out what your computer's normal BIOS does. The second time, run it with FANSI-CONSOLE FANSI-CONSOLE _____________ _____________ FANSI-CONSOLE installed. This is to find out what FANSI-CONSOLE does. Then you should compare the results. You may find this comparison easier if you use Ctrl-PrtSc before running WATZITDO to cause it to print on your printer. It is also easier if you pick a particular order to press your keys in, such as carefully going across each row in order. Use the same order with the Alt key pressed, then with the Ctrl key pressed, and lastly with a shift key pressed. If you are not careful to press the keys in exactly the same order, the results will be hard to compare. Sometimes, after running WATZITDO, you may determine that possibly several pairs of keys have been interchanged. FLAYOUT can cure this by interchanging the keys back again. However, if your keyboard has extra keys, FLAYOUT is of no use to get these keys to work. In any case, you should send us a diagram of your keyboard style, along with a description of the order in which you pressed the keys, and the results from WATZITDO. To properly support your keyboard we would need to assign another /X=? option for your computer, and add your keyboard style to the FLAYOUT menu. (C) Copyright 1984-86 Hersey Micro Consulting 13-25 (C) Copyright 1984-86 Hersey Micro Consulting 13-25 FANSI-CONSOLE Credits _____________ FANSI-CONSOLE Credits Chapter 14 Chapter 14 Credits Credits 14.1 How did you do that? 14.1 How did you do that? We know you have questions about our company and how we produce our products. Needless to say, we use only the finest unnatural ingredients. Hersey Micro Consulting, Inc. is a small new company formed in 1984 from a four year old consulting business owned by Mark Hersey. We specialize in system software for microcomputers. Our company is dedicated to promoting software portability among computers. FANSI-CONSOLE _____________ FANSI-CONSOLE was conceived as a notion that there must be a way to make the IBM-PC color graphics display adapter to scroll large portions of the screen quickly without blinking. Although we did some programming in that direction as early as January, 1983, the FANSI-CONSOLE _____________ programming of FANSI-CONSOLE as a product by itself began in earnest in November, 1983. We introduced it to the public in October, 1984. FANSI-CONSOLE _____________ The FANSI-CONSOLE source program is about 45000 lines of code written in Microsoft's Macro Assembler. For some reason, it keeps getting bigger, too. Unlike many folks, we like that assembler, including its primitive type checking. In fact, we wish it had more type checking. We use a set of macros for structured programming that give us nested IF-THEN-ELSE type statements and LOOP type statements. We wrote some utility programs in C and compiled with a Lattice C or Microsoft C compiler (we like the generated code) or a Computer Innovations C compiler (we like the library source). We often debug FANSI-CONSOLE _____________ FANSI-CONSOLE using the Microsoft Symbolic Debugger SYMDEB. (C) Copyright 1984-86 Hersey Micro Consulting 14-1 (C) Copyright 1984-86 Hersey Micro Consulting 14-1 FANSI-CONSOLE Credits _____________ FANSI-CONSOLE Credits We edited the user manual and program source using the Mark of the Unicorn's FinalWord II word processor. FinalWord II and IBM's WordProof periodically check the spelling in the user manual. Oasis System's Punctuation and Style periodically checks writing style. FinalWord II processes draft copies of the complete printed user manual including the on-disk abbreviated user manual. We generate final copies of the printed user manual by passing the FinalWord II source files through a conversion program called FW2TXF, running under MS-DOS, written by Pat Sherry at the University of Michigan. Then we transfer them to the Michigan Terminal System (MTS) at the University of Michigan and process them with a program called TEXTFORM written at the University of Alberta. We produce the camera ready copy on a Xerox 9700 page printer. We usually compile and assemble programs on a Lomas Data Products Lightning 286 S100 bus computer running MS-DOS, which we sometimes downgrade with a Seattle Computer Products 8086 board. We test the programs first and most frequently on an IBM-PC with a Tecmar Graphics Master display adapter board and a Princeton Graphics HX-12 RGB monitor. It also has an AST Six Pack Plus multi-function board, a Mountain fixed disk controller, and an Interface Inc. fixed disk system. Naturally, we use IBM-PC DOS on this computer. We also frequently test programs on a Zenith Z150, with a Seattle Computer RAM+6 board and Interface Inc. fixed disk system. Naturally, we use Z-DOS on this computer. We thank these companies and their employees for their creative efforts and for putting their useful products in the marketplace. We highly recommend them all. We also thank our beta-testers for putting up with unstable versions and providing useful comments. (C) Copyright 1984-86 Hersey Micro Consulting 14-2 (C) Copyright 1984-86 Hersey Micro Consulting 14-2 FANSI-CONSOLE Distribution and Licensing _____________ FANSI-CONSOLE Distribution and Licensing Chapter 15 Chapter 15 Distribution and Licensing Distribution and Licensing 15.1 You mean FANSI-CONSOLE is not freeware? _____________ 15.1 You mean FANSI-CONSOLE is not freeware? FANSI-CONSOLE (tm) _____________ ____ The program FANSI-CONSOLE (tm) is a commercial product and is not public domain. It is not "freeware" either, although its distribution is similar to that of "freeware". It is professional software written by professional programmers. NOT ___ We prefer NOT to call it "freeware" for three reasons: 1. The name "freeware" implies something for nothing, and we still believe that we are entitled to be paid by you for using our software, if you like it enough to use it. abbreviated ___________ 2. The distribution diskettes contain only the abbreviated user manual. We omitted several chapters describing advanced complete ________ features in detail from the complete user manual to create the abbreviated user manual. The complete user manual is not free. You must buy it if you want one. 3. "Freeware" is also a trademark of The Headlands Press, Inc. and not of our own. If it were not trademarked and were merely a generic classification, we would have less complaint about that aspect of things. Instead, perhaps we should call it "fairware". We want things to be fair for you and for us. FANSI-CONSOLE _____________ The basic difference between the license for FANSI-CONSOLE and that FANSI-CONSOLE _____________ of software which is freeware is that use of FANSI-CONSOLE beyond a _________ _____ _______ free trial period, is subject to a low mandatory usage royalty _______ payment instead of a voluntary usage royalty payment. Sometimes it is called a "contribution" in the latter case. Unlike many commercial software vendors, we feel that you are entitled to a test drive with our software for a free trial period. On the other hand, like many commercial software vendors, we feel that if you continue use our software you should pay us for the privilege. The price you pay should still be fair, but it should not be free. (C) Copyright 1984-86 Hersey Micro Consulting 15-1 (C) Copyright 1984-86 Hersey Micro Consulting 15-1 FANSI-CONSOLE Distribution and Licensing _____________ FANSI-CONSOLE Distribution and Licensing 15.2 How are you limiting my use of FANSI-CONSOLE? _____________ 15.2 How are you limiting my use of FANSI-CONSOLE? FANSI-CONSOLE (tm) abbreviated _____________ ____ ___________ The program FANSI-CONSOLE (tm) and its abbreviated user manual are copyrighted restricted ___________ __________ copyrighted by Hersey Micro Consulting, Inc. We give restricted permission to make unlimited numbers of copies for personal use. We restricted __________ also give restricted permission to make unlimited numbers of copies of the diskettes for distribution to others. To allow such copying, ___ we did not copy protect it. 15.2.1 Limitations 15.2.1 Limitations The restrictions on this permission to make unlimited numbers copies ___ ____________ __ ____ __________ __ ____ _________ _______ ______ The restrictions on this permission to make unlimited numbers copies are as follows: ___ __ ________ are as follows: _______ ______ __ ___ ____ _______ _______ ___________ __ 1. Printed copies of the user manual, whether abbreviated or _________ ____ ___ __ ___________ complete, must not be distributed without a written license from Hersey Micro Consulting, Inc. to do so, even if it is done FANSI- ______ for free and with no service charge. All copies of FANSI- CONSOLE abbreviated _______ ___________ CONSOLE and its abbreviated user manual which are distributed to others must be on magnetic media, such as diskettes, or via electronic communications such as via electronic bulletin board systems or electronic information networks. The recipients must each print their own copies of the abbreviated user manual. ___ _____ __ ___ ________ ____ ______ ____ ___ ___ __ ___ 2. The parts of the complete user manual that are not in the ___________ ____ ______ ____ ___ __ ___________ abbreviated user manual must not be distributed in any form, especially printed or on magnetic media, without a written license from Hersey Micro Consulting, Inc. Nor should any part FANSI-CONSOLE _____________ of FANSI-CONSOLE be included with another product which is for sale without payment of our usage royalty. (C) Copyright 1984-86 Hersey Micro Consulting 15-2 (C) Copyright 1984-86 Hersey Micro Consulting 15-2 FANSI-CONSOLE Distribution and Licensing _____________ FANSI-CONSOLE Distribution and Licensing ___ ______ ___________ __ ______ ____ _______ _____ _________ 3. All copies distributed to others must include files identical __ ___ ___ ________ _____ to all the original files. A list of files is included in this manual. So the program must not be distributed without the abbreviated user manual, for example. You may condense the files via data compression techniques if the decompression process results in files identical to all the original files, and that the decompression program is included on the media in object form. Versions of the program or abbreviated user manual which have been otherwise modified, or incorporated into other programs in whole or in part, must not be further distributed. You may add files indicating program patches, or user manual addenda, to the media as separate files, providing that there is room for such files on the media. Such changes must not remove or change the copyright notices found in the program or abbreviated user manual. ___ __ FANSI-CONSOLE ______ ___ ________ ____ __ _____ ___ __ _____________ 4. Use of FANSI-CONSOLE beyond ten business days of first use of ___ ________ ___ _____ _____ ________ __ _______ __ _ _________ the program, the "free trial period", is subject to a mandatory _____ _______ _______ __ ___ _______ usage royalty payment of $25 (MI+4%) (United States) per computer console (CRT) on which you may simultaneously use it. This is true unless you have received the published (printed and bound) form of the complete user manual, the cost of which includes the usage royalty payment for one computer console (CRT). This usage royalty must be delivered directly to Hersey Micro Consulting, Inc. at the address on the cover page of this manual. The free trial period is intended to allow you to try the program before paying for it. If at the end of the free trial period, you decide you do not want to pay the usage royalty, you may do this providing you never again use any copies of the program which are or will be in your possession. Even in this case you may further distribute them. Obviously, even though payment is legally mandatory, we are relying on your honesty, because in most cases, we do not have much capability to enforce it. Remember that your payment will help us to afford to develop other fine programs that you may also be interested in using. You can not expect quality software for free. FANSI-CONSOLE _____________ 5. Serial reuse, or moving FANSI-CONSOLE from one computer console to use it on another, is specifically allowed. We do require FANSI-CONSOLE _____________ that either FANSI-CONSOLE is first removed from the original computer console (CRT) before use on the second, or that the original computer console (CRT) be unattended during use on the FANSI-CONSOLE _____________ second. Thus FANSI-CONSOLE is only in active use on one computer console at a time. This is roughly the same as the concept of a per user license. (C) Copyright 1984-86 Hersey Micro Consulting 15-3 (C) Copyright 1984-86 Hersey Micro Consulting 15-3 FANSI-CONSOLE Distribution and Licensing _____________ FANSI-CONSOLE Distribution and Licensing __________ __ FANSI-CONSOLE ______ ___________ __ ______ ____ _____________ 6. Recipients of FANSI-CONSOLE copies distributed to others must ___ __ _______ ___ ___ _____ _______ __ __________ not be charged for the usage royalty by unlicensed ____________ distributors. The recipients must be encouraged to follow the terms of this licensing agreement. Recipients should note that this means that payment of such distribution fees does not cover the usage royalty, which must still be paid to Hersey Micro Consulting, Inc., if the program is used beyond the free trial period. You may make distribution charges (such as materials and postage) if they are no more than $10 per diskette and no more than that charged for other media of similar construction, capacity, and quantity from the same distributor. Similarly, you may buy sample diskettes directly non-refundable ______________ from Hersey Micro Consulting, Inc. for the non-refundable charge of $12, which is not applicable towards the usage royalty fee. (C) Copyright 1984-86 Hersey Micro Consulting 15-4 (C) Copyright 1984-86 Hersey Micro Consulting 15-4 FANSI-CONSOLE Distribution and Licensing _____________ FANSI-CONSOLE Distribution and Licensing 15.2.2 Rights 15.2.2 Rights Payment of the usage royalty fee entitles you to: 1. A copy of the current program directly from us. This does not include printed complete user manual. use FANSI-CONSOLE ___ _____________ 2. A license to use updated versions of the FANSI-CONSOLE software, if you can obtain them, for no additional usage not ___ royalty fee. It does not include the costs of distributing such we updated versions. If we send you the new version you have to pay our reasonable update fee. This essentially allows you to get fixes for bugs without paying for an update. Please note NOT that this does NOT require us to provide details of newer features in any on diskette documentation. FANSI-CONSOLE _____________ 3. Request help with solving FANSI-CONSOLE related problems. We do not guarantee that we will give telephone help to unlicensed users. Remember that such things cost a good deal of money to support. We have set up a bulletin board system to provide information about new versions and a mechanism for initiating problem resolution. The bulletin board system phone number is (313)-994-3946. 4. Assignment of a new serial number. It will be placed in the version heading of any update you receive directly from us. It should be used as an identifying number when requesting updates or help. 5. Automatic notification of new versions which require an NOT ___ updated complete printed user manual. This notification is NOT for ALL versions! We will not notify you of new beta test versions. 6. Feel good about yourself. You have supported the cause of inexpensive software, with minimal usage restrictions. (C) Copyright 1984-86 Hersey Micro Consulting 15-5 (C) Copyright 1984-86 Hersey Micro Consulting 15-5 FANSI-CONSOLE Distribution and Licensing _____________ FANSI-CONSOLE Distribution and Licensing 15.3 How do I know if FANSI-CONSOLE is right for me? _____________ 15.3 How do I know if FANSI-CONSOLE is right for me? 15.3.1 DISCLAIMER 15.3.1 DISCLAIMER FANSI-CONSOLE _____________ FANSI-CONSOLE and its user manual are provided "as is". If you do not like it after the free trial period, do not use it. If you do not use it after the free trial period, do not pay for it. We cannot warrant it for all possible purposes, as we know that even quality software has some limitations. We have even tried to notify you of the limitations we already know about. We cannot warrant it for your specific purposes, because it would cost us much more to determine its suitability for your purposes than we are charging. FANSI-CONSOLE _____________ It is up to you to determine the suitability of using FANSI-CONSOLE with any other program or with any computer. Mention of any other program or a computer in this manual is not a guarantee by Hersey FANSI-CONSOLE _____________ Micro Consulting, Inc. of suitability of using FANSI-CONSOLE with that other program or computer. We do occasionally make mistakes in the user manual, and they cannot always be rectified by changing the program. In no event will Hersey Micro Consulting, Inc. be liable, either to you or to any other party, for any damages, including loss of profits, lost savings, or other incidental or consequential damages FANSI-CONSOLE _____________ arising out of the use of or inability to use FANSI-CONSOLE, even if we have been advised of the possibility of such damages. Since you may have received this version from someone other than Hersey Micro Consulting, Inc., it may have been mangled on its way to you. We obviously can not warrant that no one has done that. We certainly hope no one will do that, anyway. We reserve the right to make modifications to the program and user manual without notification to you. Especially if you do not pay the usage royalty. (C) Copyright 1984-86 Hersey Micro Consulting 15-6 (C) Copyright 1984-86 Hersey Micro Consulting 15-6 FANSI-CONSOLE Distribution and Licensing _____________ FANSI-CONSOLE Distribution and Licensing 15.4 What do we pay if we have more than one computer? 15.4 What do we pay if we have more than one computer? You may buy multiple copy licenses from Hersey Micro Consulting, Inc. The charge for such a multiple copy license is essentially $25 (MI+4%) (United States) per computer console (CRT) owned by the FANSI-CONSOLE _____________ licensing entity on which you may use simultaneously FANSI-CONSOLE. If the licensing entity buys additional computers, the royalty should be recalculated and the increase paid annually. A multiple copy license covers all use by all employees or students, regardless of whether the computers used are owned by the licensing entity. So home use is included, for example. Multiple copy license pricing does not include any printed user manuals. You may buy them an additional $50 (MI+4%) each. Quantity discounts are available. Ask us about them, as the prices may change over time. (C) Copyright 1984-86 Hersey Micro Consulting 15-7 (C) Copyright 1984-86 Hersey Micro Consulting 15-7 FANSI-CONSOLE Distribution and Licensing _____________ FANSI-CONSOLE Distribution and Licensing 15.5 Can I get a printed complete FANSI-CONSOLE user manual? _____________ 15.5 Can I get a printed complete FANSI-CONSOLE user manual? The complete printed user manual in "IBM standard" size loose leaf binders with slip covers retails for $75 (MI+4%). The $75 retail price includes: the printed manual; a usage royalty fee for one computer console (CRT); one distribution diskette set with the program and a magnetically copyable version of the abbreviated user manual. This is the "commercial" version of the program. When the order is prepaid, the wholesale price also includes ground shipping by UPS within the USA. Other shipping arrangements require a shipping charge. FANSI-CONSOLE _____________ If you received FANSI-CONSOLE from us or from another commercial product vendor, and did not receive a printed user manual, then you FANSI-CONSOLE _____________ may have received our registration coupon with your FANSI-CONSOLE serial number on it. Receiving that coupon means that the vendor has FANSI-CONSOLE _____________ paid us to distribute FANSI-CONSOLE with their product, and it means that your usage royalty for one computer console (CRT) has already been paid for you by the vendor. If you did not receive our registration coupon with your serial number on it, or a printed user manual, then the vendor did not pay your usage royalty fee, and you must pay it yourself. The registration coupon is redeemable for a printed user manual at the reduced cost of $50 (MI+4%). We did not include the complete user manual on the distribution diskettes for several reasons: ________ __ _____ ___ ___ __ _ _________ _____ 1. Frankly, it would not fit in a printable form. At least, not the way we want it printed. 2. Even if using data compression might have made it fit, it would have scared away some potential users, and made printing inconvenient. 3. An abbreviated user manual is quicker and less discouraging to print, or to download from a bulletin board system. 4. We wanted some control over how it got abbreviated, for people desiring only a shorter form. 5. It provides some small encouragement to pay us for our hard work. (C) Copyright 1984-86 Hersey Micro Consulting 15-8 (C) Copyright 1984-86 Hersey Micro Consulting 15-8 FANSI-CONSOLE Distribution and Licensing _____________ FANSI-CONSOLE Distribution and Licensing 15.6 How do I get updated versions of FANSI-CONSOLE? _____________ 15.6 How do I get updated versions of FANSI-CONSOLE? All prices below are subject to change if our costs get out of hand. We will try to hold the price as low as possible, to encourage everyone FANSI-CONSOLE ________ _____________ everyone to use FANSI-CONSOLE. We've already been told by distributors that our price is ridiculously low, but we will keep these prices as long as we can. It is also the case that as the program grows in function, the printed user manual will grow in size, and this will require a higher price for the manual. If you have paid the usage royalty fee and have filled out and returned our registration form, you may buy updated versions of the program and abbreviated user manual, or versions on differently formatted diskettes, from Hersey Micro Consulting, Inc. for $12 (MI+4%) per distribution diskette set. This requires a previously or simultaneously paid usage royalty fee. The price includes the media, so please do not send us any. We do not want our mailperson to be overwhelmed with incoming packages. Of course, you can also get software updates from other customers of Hersey Micro Consulting, Inc., for whatever they charge. If you have paid the usage royalty fee and have filled out and returned our registration form, you may buy updated versions of the program and complete printed user manual, from Hersey Micro Consulting, Inc. for $25 (MI+4%) per copy. This requires a previously or simultaneously paid usage royalty fee. The upgrade has new printed pages for the binder and a distribution diskette set. If you previously bought the shareware version, without the complete printed manual, your coupon still entitles you to upgrade to the new complete printed user manual, including binder and software, at the price indicated on the coupon. You can order directly by phone or by mail. You only need to return your old version distribution diskette one, if your address on your registration or original order has changed. If you have paid the usage royalty fee and have filled out and returned our registration form, we will automatically notify you of new versions which require an updated complete printed user manual. Diskettes are currently available in 8-inch SSSD, SSDD, and DSDD formats and most 5-inch DSDD formats. We also expect availability in some sub-4-inch formats when such formats become more common. We are sorry, but we cannot directly support formats requiring one-of-a-kind hardware, such as Victor 9000 (Sirius 1), Apple II, or any type of hard sectored diskettes. Orders requiring such one-of-a-kind hardware will require an extra $25 processing charge per order, assuming we can find such hardware to borrow. (C) Copyright 1984-86 Hersey Micro Consulting 15-9 (C) Copyright 1984-86 Hersey Micro Consulting 15-9 FANSI-CONSOLE Distribution and Licensing _____________ FANSI-CONSOLE Distribution and Licensing If you send in your registration form, we will notify you of new FANSI-CONSOLE _____________ versions of FANSI-CONSOLE, but only those that we consider significantly different. These versions will require printed manual updates. (C) Copyright 1984-86 Hersey Micro Consulting 15-10 (C) Copyright 1984-86 Hersey Micro Consulting 15-10 FANSI-CONSOLE Distribution and Licensing _____________ FANSI-CONSOLE Distribution and Licensing 15.7 Can I publish FANSI-CONSOLE? _____________ 15.7 Can I publish FANSI-CONSOLE? Unless the publisher has significant international connections, we are currently uninterested in having our printed manual and other packaging reprinted, reworked, or redesigned by others. We are however interested in publishers and distributors able to provide significant exposure for our product in foreign countries, preferably with translated text. FANSI-CONSOLE _____________ You may want to include FANSI-CONSOLE with your hardware or software product. We can provide you with a license to distribute diskettes with serialized registration coupons redeemable for reduced cost printed user manuals. The license cost includes the usage royalty fee for one computer console (CRT) for each recipient of a serialized registration coupon. Essentially, all we are doing is selling you a particular lot of serial numbers and a clear conscience. However, your customer gets an even bigger bargain on our product. Generally, we would prefer that you use a license if you distribute our software with your product. Distributing our software with your product without the license falsely implies to the customer that you've paid us a royalty and therefore that customer has already paid to use our software. 15.8 Can I buy the FANSI-CONSOLE program source? _____________ 15.8 Can I buy the FANSI-CONSOLE program source? FANSI-CONSOLE _____________ The source program for FANSI-CONSOLE is available only by non- ____ exclusive license requiring non-disclosure and only for a very large fee. It is definitely not available as shareware or as a reasonably priced end-user product. We do have some stake in keeping the source to ourselves at least until we have made some money from our efforts. (C) Copyright 1984-86 Hersey Micro Consulting 15-11 (C) Copyright 1984-86 Hersey Micro Consulting 15-11 FANSI-CONSOLE _____________ FANSI-CONSOLE FANSI-CONSOLE _____________ FANSI-CONSOLE REGISTRATION FORM Complete this form to be eligible for updates Today's Date: Release number: Serial number: Person completing form: Company: Street Address: Phone: From whom did you first receive this product: FANSI-CONSOLE _____________ Where did you first hear of FANSI-CONSOLE: What type of computer are you using it on: What type of display adapter do you use: What types of software do you use that you FANSI-CONSOLE _____________ have found FANSI-CONSOLE speeds up: Other Comments: (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE FANSI-CONSOLE _____________ FANSI-CONSOLE USAGE AND PROBLEM REPORT QUESTIONNAIRE We at Hersey Micro Consulting greatly appreciate your taking the time to complete this questionnaire. Your suggestions and comments are important to us, as they help us both to evaluate and improve our products. Please feel free to file this report with us more than once. Today's Date: Release number: Serial number: Person completing form: Company: Street Address: Phone: From whom did you first receive this product: FANSI-CONSOLE _____________ Where did you first hear of FANSI-CONSOLE: What type of computer are you using it on: What type of display adapter do you use: What MS-DOS version and other resident programs were being used? During the usage period, about how many hours per day did you use this product on average? Do you have any experience with similar products, even on other computers? If so, please describe the products and computers. How long have been using computers? Please give a brief description of your business and how this product was used: (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE Using a scale of 1 to 10 (1=terrible, 5=average, 10=excellent) please indicate your general satisfaction with the following: The product on the whole: The user manual: The setup procedures: The ease of using this product: The practicality or usefulness of this product: The performance of this product: The help given by Hersey Micro Consulting: The following questions may require more lengthy responses. Please use the reverse side of this sheet or additional sheets of paper as necessary. What would you say are the BEST features of this product? What would you say are the WORST features of this product? List any extraneous or useless features of this product that you have noticed. List any enhancements you would like to see added to the existing features of this product. Describe any problems you have encountered in using this product, including examples if possible. (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE Hersey Micro Consulting, Inc. Invoice # 8401 P.O. Box 8276 Michigan and Federal Ann Arbor, MI USA 48107 EIN 38-2532624 (313) 994-3259 Date: / / Retail prices starting 10/01/86 Name, street address, phone: Product Quantity Price Each Item Total FANSI-CONSOLE _____________ FANSI-CONSOLE: complete user manual ___ @ $75.00 = ______ (includes software) software usage royalty ___ @ $25.00 = ______ (includes coupon for manual) sample diskettes set DSDD ___ @ $12.00 = ______ (non-refundable) Subtotal: ______ 4% sales tax (Michigan residents) x0.04= ______ Shipping if not UPS ground to USA ($2 COD) ______ Total: ______ Make checks payable to: Hersey Micro Consulting, Inc. MasterCharge and Visa are accepted. Card number: ____________________ Expires: ______ Retain a copy of this invoice for your tax records. (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE Glossary ________ Glossary active position The place on the screen where the next character will be imaged. Generally, the cursor is at the active position. ASCII value The numeric value used to represent a character. BIOS Basic Input Output System. C0 set The control functions currently specified by the control characters between 000 and 01F hex. C1 set The control functions currently specified by the control characters between 080 and 09F hex. CGA IBM Color Graphics Adapter or clone. clone A functionally equivalent replacement. console The screen and the keyboard together. control function An action that affects the console. control sequence A sequence of characters used to cause control functions. current graphics rendition The graphics rendition used for new characters as they are written to the display. If FANSI-FILLER and FANSI- VT100 are reset, it is also used for erasing characters from the display. designate To specify which graphic character set is associated with G0, G1, G2, or G3. device driver A resident program that controls a hardware device. display The area on the screen in which characters are displayed, or the characters in that area. ECD IBM Enhanced Color Display or clone. EGA IBM Enhanced Graphics Adapter or clone. escape sequence A control sequence that begins with the escape character. (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE filler graphics rendition The erased or screen graphics rendition. If FANSI-FILLER or FANSI-VT100 are set, it is used for erasing characters from the display. This is also the graphics rendition from which a "reverse video" current graphics rendition is generated by reversing its foreground and background colors, and from which a "concealed" current graphics rendition is generated by changing the foreground to the same color as the background. G set A 94 or 96 graphic character set which you may invoke into GL or GR. G0, G1, G2, and G3 are G sets. GL set The graphic characters currently specified by the bytes with values between 021 and 07E hex. GR set The graphic characters currently specified by the bytes with values between 0A0 and 0FF hex for a 96-character set, or between 0A1 and 0FE hex for a 94-character set. graphic character The name used in standards for a displayable character. graphic rendition A visual style of displaying characters. Includes the foreground and background colors, underlining, reversedness, concealedness, blinking, brightness, and font. hashing The ugly "snow" sometimes seen on screens connected to poorly designed display adapters. horizontal retrace The movement of the video scan (light) from the right side of the screen to the left side. During this time period the light is turned off. installation option FANSI-CONSOLE _____________ A FANSI-CONSOLE DEVICE= line slash options. invoke To specify which G set from G0-G3 is used in GL or GR for displaying characters. You invoke with a either a locking shift or a single shift control sequence. keyboard layout A logical, conceptual arrangement of keys on the keyboard. This may differ from the physical arrangement. You may change it using FLAYOUT. keyboard style The physical arrangement of keys on the keyboard. The keyboard style is permanent. (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE macro A string of characters assigned to a key. MDPA IBM Monochrome Display and Printer Adapter or clone. numeric parameter A control function parameter that provides a value required for the function. overlap The number of current lines that remain on the screen when paging up or down. pixel A single point on the screen which may be either glowing or dark. PGA IBM Professional Graphics Adapter or clone. primary graphics rendition The default or basic graphics rendition. This is the graphics rendition from which the filler graphics FANSI-CONSOLE _____________ rendition is generated. FANSI-CONSOLE does this by reversing its foreground and background colors, if the screen mode (SCRN) is set. The method of setting this rendition depends on the settings of FANSI-COLOR and FANSI-NOCOLOR. reset Off or disabled. resident program A program which is always in read/write memory or ROM after MS-DOS is started. ROM Read Only Memory. run-time The time during which a program is running. scan line A horizontal row of pixels on the screen. screen display mode The mode set using the FANSI-SCRNMODE control function. It may also be set using IBM-RM or IBM-SM or BIOS calls. screen writing The processing of filling the screen with information by writing to it. scrolling region The region of the screen indicated by the last SSR control function. The current control functions affect only this limited area. selective parameter A control function parameter that selects one of several options for the function. (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE set On or enabled. shift A control sequence which invokes a G set from G0-G3 into GL or GR. subfunction One of several control functions performed by a single control sequence. system disk A bootable disk. Has the MS-DOS system files on it. type ahead Keystrokes made when the currently running program is not reading them. type ahead buffer Place where type ahead is stored before the currently running program reads it. vertical retrace The movement of the video scan (light) from the bottom of the screen to the top. During this time period the light is turned off. (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE Index Index /A option attributes 3-6, 6-16 /B option blinking scroll mode 3-7 /C option color what you can 3-8, 6-44, 9-12 /D option double scan characters 3-9, 6-46 /F option font table address 3-9, 13-20 /G option Ctrl-G bell length 3-10 /H option horizontal delay mode 2-14, 3-11 /I option controller initialization parameters 3-12 /J option just DOS macros 3-13 /K option keyboard language 3-13 /L option lock on Scroll-Lock 2-16, 2-17, 3-14, 10-1 /M option memory allocated 3-16, 3-32 /N option no color display 3-17, 6-44, 9-12 /O option one finger typing 3-18 /P option page overlap 3-19, 10-2, 10-3 /Q option quick scroll mode 3-20 /R option recall line maximum 3-21, 3-32, 10-1, 10-3 /S option screen save timeout 3-23 /T option use ANSI X3.64 TTY ROM BIOS 3-24 /V option vertical delay mode 3-25 /W option word wide move mode 3-26 /X option extensions 3-27 /Y option (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE you should be so compatible 3-29, 9-11 /Z option zzzz sleep value 3-31 25 line display 2-4 43 line display 2-4 50 line display 1-9, 2-4 A A abbreviated user manual 2-5, 2-6 access methods screen 4-1 adapters 3-3, 3-4, 3-11, 3-17, 3-24, 3-26, 3-27 compatible 13-13 Alt-Ctrl-Caps 11-12 Alt-Ctrl-Dash 6-60 Alt-Ctrl-Esc 11-2, 11-4 Alt-Ctrl-Grave 2-17 Alt-Ctrl-Ins 1-9, 12-1 Alt-Ctrl-LightMinus 6-60 Alt-Ctrl-Num-Lock 11-13 Alt-Ctrl-Scroll-Lock 11-10 Alt-Ctrl-Tab 11-1, 11-4 Alt-Scroll-Lock 10-1 alternate print screen 9-22 ANN 7-11, 8-11 ANSI - ANSI/VT52 mode 6-8 ANSI.SYS device driver 1-2, 1-4, 2-9, 2-19, 3-2, 5-3, 5-4, 5-23, 6-76 ANSI80.TXT 2-3, 5-4 ANSI mode 6-8 ANSI X3.64 1-4, 3-24 ANSI X3.64 control sequences 5-3 ANSI X3.64 mnemonic table 6-75 ANSI X3.64 syntax table 6-80 APC - Application Program Command 6-8 assembly language control sequences 5-22 assignment strings 11-7 AT.LAY 2-3, 11-6 attributes 3-6, 3-8, 3-17, 6-54, 6-56, 6-59 AUTOEXEC.BAT 2-15 auto repeat keyboard keys 6-56 auto wrap mode 6-73 auxiliary device 6-50 B B background color 6-61 back space 6-9 backward 6-9, 6-12, 6-13 (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE BASIC control sequences 5-19 BBS 15-8 beginning state 6-54 BEL - BELl 6-8 bell 6-8 bell length 3-10 BIOS calls 9-1 keyboard 9-3 pass through 9-5, 9-24 screen 9-10 TTY calls ANSI X3.64 3-24 blink free scrolling 3-7, 3-20 blinking 6-60, 6-61 bold 6-60 breakpoint 1-9, 12-1 BS - Back Space 6-9 BSLASH 5-15 BUFFERS=20 2-12 bugs 13-5 bulletin board system 13-4, 15-5, 15-8 C C C0 7-4, 8-4 C1 7-4, 8-4 caps lock true 1-6 caps unlock 1-6 CARET 5-15 carriage return 6-12 CBT - Cursor Backward Tabulation 6-9 CHA - Cursor Horizontal Absolute 6-9 character delete 6-16 character erase 6-21 character insert 6-45 character names 5-15 character set designaters 7-8, 8-8 character sets change 9-19 CHARSETS.TXT 2-3, 7-9, 8-9 cheating 9-1 CHT - Horizontal Tabulation 6-10 CK - Cursor Key mode 6-10 C language control sequences 5-20 clear character 6-21 clear display 6-22 clear line 6-22 clear screen 6-22 click duration keyboard key 1-11, 9-4 (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE click frequency keyboard key 1-11 click repeats keyboard key 1-11 CNL - Cursor Next Line 6-10 COL - COLumn mode 6-11 color 1-10, 3-8, 6-54, 6-56, 6-59, 6-61 color ROM BIOS calls 3-17 colors set 9-16, 9-18 color what you can 3-8 column mode 6-11 commercial version 15-8 COMn: 6-50 compatibility 3-29 compatible adapters 13-13 compatible computers 13-13 compatible programs 13-7 complete user manual 15-8 compression 15-8 computer independence 4-1 computers compatible 13-13 CONFIG.SYS 2-8, 2-9, 2-11, 2-12, 2-19, 3-2, 3-4 console 1-1 console driver 2-9 control functions do 7-1, 7-3, 7-6, 7-9, 7-13, 8-1, 8-3, 8-6, 8-9, 8-13 controller initialization 3-12 control sequence 5-3 control sequence introducer 6-12 control sequence mnemonic table 6-75 control sequence name table 6-2 control sequences 1-4, 5-1, 5-15, 5-18, 6-1, 6-7 editing 5-6 putting into a file 5-6 control sequence syntax table 6-80 conventions 5-15 CPL - Cursor Preceding Line 6-11 CPR - Cursor Position Report 6-11, 9-14 CR - Carriage Return 6-12 C sets 7-5, 8-5 CSI - Control Sequence Introducer 6-12 CTC - Cursor Tabulation Control 6-13 Ctrl-[ 6-23 Ctrl-Break 2-17, 6-20, 6-47 Ctrl-C 2-17, 6-20, 6-47 Ctrl-F 2-16 Ctrl-F5 10-9 Ctrl-G 3-10, 6-8 Ctrl-H 6-9 Ctrl-I 6-38 Ctrl-J 6-48 Ctrl-K 6-73 (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE Ctrl-M 6-12 Ctrl-Num-Lock 2-16, 2-17, 3-14 Ctrl-PrtSc 10-8 Ctrl-S 2-16, 2-17, 3-14 CTTY 4-3 CUB - CUrsor Backward 6-13 CUD - CUrsor Down 6-14 CUF - CUrsor Forward 6-14 CUP - CUrsor Position 6-14, 9-14 current graphics rendition 3-8, 6-58, 6-59 cursor backward 6-13 cursor backward tab 6-9 cursor down 6-14, 6-15 cursor forward 6-14 cursor horizontal absolute 6-9 cursor horizontal tab 6-10 cursor key mode 6-10 cursor left 6-13 cursor movement 6-9, 6-10, 6-11, 6-12, 6-13, 6-14, 6-15, 6-38, 6-39, 6-46, 6-48, 6-50, 6-51, 6-52, 6-54, 6-56, 6-68, 6-72, 6-73, 9-14 cursor next line 6-10 cursor position 6-14, 9-14 cursor position report 6-11, 9-14 cursor preceding line 6-11 cursor right 6-14 cursor shape 9-13, 9-14 cursor size 9-13 cursor tabulation control 6-13 cursor up 6-15 cursor vertical absolute 6-72 cursor vertical tabulation 6-15 CUU - CUrsor Up 6-15 CVT - Cursor Vertical Tabulation 6-15 D D DA 3-6 DA - Device Attributes 6-16 data compression 15-8 DC1 6-74 DC3 6-74 DCH - Delete CHaracter 6-16 DCS - Device Control String 6-17 dealers 15-7 DEC-ANM 6-8 DEC-ARM 6-56 DEC-AWM 6-73 DEC-CKM 6-10 DEC-COL 6-11 DEC-GM 6-17 DEC-KPAM - DEC Key Pad Alternate Mode 6-47 DEC-KPNM - DEC Key Pad Numeric Mode 6-47 (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE DEC-OM 6-52 DEC-RM - DEC Reset Mode 6-17 DEC-SCNM 6-58 DEC-SM - DEC Set Mode 6-18 DEC-TM - DEC Toggle Mode 6-19 decrement option value 6-23 DEC VT100 emulation 1-5, 11-13 DEC VT52 emulation 1-6 DEJAVU 10-10 DEJAVU.EXE 2-3 Del 10-3 delay horizontal retrace 3-11 keyboard key repeat 9-4 vertical retrace 3-25 delete character 6-16 delete line 6-19 deleting scroll recall lines 10-9 designaters 7-8, 8-8 designating characters sets 7-5, 8-5 detecting FANSI-CONSOLE installation 4-4 DEVICE= 2-8, 2-9 device attributes 6-16 device driver 2-9, 3-1 device status report 6-21 disable keyboard 6-20, 6-47 disable manual input 6-20 disclaimer 15-6 display BIOS calls 9-10 software interrupt 9-11 display control characters 7-1, 7-3, 7-6, 7-9, 7-13, 8-1, 8-3, 8-6, 8-9, 8-13 display erase 6-22 display state get 9-17, 9-22 distribution 15-1 distribution diskettes 2-3 DIZZY.C 2-3 DL - Delete Line 6-19 DLE - Data Link Escape 6-20 DMI - Disable Manual Input 6-20 do control functions 7-1, 7-3, 7-6, 7-9, 7-13, 8-1, 8-3, 8-6, 8-9, 8-13 documentation 2-5, 2-6, 15-8 dot read 9-17 write 9-16 double scan characters 3-9, 6-46 down 6-10, 6-14, 6-15, 6-46, 6-48 DownArrow 10-2 DSR - Device Status Report 6-21 duration keyboard key click 1-11 (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE DVORAK.TXT 2-4, 5-4, 11-1 Dvorak keyboard 2-4, 11-1, 11-4, 11-6 E E ECH - Erase CHaracter 6-21 ECHO control sequences 5-7 ED - Erase in Display 6-22 editing control sequences 5-6 editing mode horizontal 6-36 vertical 6-72 EDLIN 5-6 EGALGCHR.COM 2-4 EGASMCHR.COM 2-4 EL - Erase in Line 6-22 EMI - Enable Manual Input 6-23 emulation DEC VT100 1-5, 11-13 DEC VT52/Heath H19/Zenith Z100 1-6 enable keyboard 6-23, 6-47 enable manual input 6-23 End 10-3 erase character 6-21 erase display 6-22 erase line 6-22 erase screen 6-22 ESC 5-15 ESC - ESCape 6-23 escape 6-23 escape sequence 5-3 escape sequence mnemonic table 6-75 escape sequence name table 6-2 escape sequences 1-4 editing 5-6 putting into a file 5-6 escape sequence syntax table 6-80 EXPAND.COM 2-4 extensions 3-27 F F F1 10-5 F10 10-5 F2 10-5 F3 10-5 F4 10-5, 10-6 F5 10-9 F6 10-6 (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE F7 10-5 F8 10-5 F9 10-5 facilities announcers 7-11, 8-11 FANSI 1-1 FANSI-ALTPRINT - FANSI ALTernate PRINT screen mode 9-22 FANSI-BELL - FANSI Ctrl-G BELL length 3-10 FANSI-BLINK - FANSI BLINKing scroll mode 3-7 FANSI-CLICK - FANSI key CLICK duration 9-4 FANSI-CMP - FANSI bios CoMPatibility mode 3-29, 9-11 FANSI-COLOR - FANSI COLOR what you can mode 3-8, 6-44, 9-12 FANSI-CONTROL - FANSI do CONTROL functions mode 7-1, 7-3, 7-6, 7-9, 7-13, 8-1, 8-3, 8-6, 8-9, 8-13 FANSI-DBLSCAN - FANSI DouBLe SCAN characters mode 3-9, 6-46 FANSI-DEVATTR - FANSI DEVice ATTRibutes 3-6, 6-16 FANSI-DOV 6-23 FANSI-DVORAK - FANSI DVORAK keyboard mode 11-1, 11-2 FANSI-ECDBORDER - FANSI ECD BORDER mode 6-59, 9-16 FANSI-FILLER - FANSI use FILLER for erase mode 6-59 FANSI-GM 6-24 FANSI-GOV 6-25 FANSI-HANDICAP - FANSI HANDICAP shift mode 3-18 FANSI-HORZDELAY - FANSI HORiZontal DELAY mode 3-11 FANSI-IOV 6-25 FANSI-JUSTDOS - FANSI JUST DOS macros mode 3-13 FANSI-KEYDELAY - FANSI KEY repeat DELAY 9-4 FANSI-KEYRATE - FANSI KEY repeat RATE 9-4 FANSI-KKR - FANSI Keyboard Key Reassignment 11-7, 11-10 FANSI-LANGUAGE - FANSI keyboard LANGUAGE 3-13, 9-5 FANSI-LAYOUT 11-3 FANSI-LOCK - FANSI LOCK on Scroll-Lock mode 3-14 FANSI-MACRO - FANSI MACROs mode 11-12 FANSI-NOCOLOR - FANSI NO COLOR display mode 3-17, 6-44, 9-12 FANSI-OVERLAP - FANSI page OVERLAP 3-19 FANSI-PARALLEL - FANSI PARALLEL port 6-50 FANSI-QUICK - FANSI QUICK scroll mode 3-20 FANSI-RECALL - FANSI RECALL buffer lines 3-21, 10-1 FANSI-RM 6-26, 10-3 FANSI-SAVE - FANSI line SAVE mode 10-3 FANSI-SAVEGRAPH - FANSI SAVE GRAPHics lines mode 10-3, 10-4 FANSI-SCRNMODE - FANSI SCReeN MODE 9-12 FANSI-SCRNTIME - FANSI SCReeN save TIMEout 3-23 FANSI-SERIAL - FANSI SERIAL port 6-50 FANSI-SM 6-27, 10-3 FANSI-SOV 6-32 FANSI-TM 6-35 FANSI-TOPVIEW - FANSI TOPVIEW emulation mode 9-23 FANSI-TTY - FANSI X3.64 TTY bios mode 3-24, 5-17, 5-19, 9-17 FANSI-VERTDELAY - FANSI VERTical DELAY mode 3-25 FANSI-WORDWIDE - FANSI WORD WIDE move mode 3-26 FANSI-ZSLEEP - FANSI Zzzz SLEEP value 3-31 FANSICAP.TXT 2-4 FANSISET.EXE 2-4 FANSISET.TXT 2-4, 2-15, 5-4 (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE fast 3-26, 3-29 FCONBBS.LST 2-4 FCONBETA.DEV 2-4, 2-8 FCONSOLE.DEV 2-8, 2-11, 2-19, 3-5 FCONSOLE.HST 2-5 fifty line display 1-9 file list 2-3 filler graphics rendition 6-58, 6-59 fixed disk 2-8 flash free scrolling 3-7, 3-20 FLAYOUT 11-3 FLAYOUT.EXE 2-5, 13-25 flicker 3-9 flicker free scrolling 3-7, 3-20 font 3-9 foreground color 6-61 FORMAT does not work 2-12 forward 6-14 free trial period 15-3 freeware 15-1 G G G0 6-48, 7-5, 7-8, 8-5, 8-8 G1 6-48, 7-5, 7-8, 8-5, 8-8 G2 6-49, 7-5, 7-8, 8-5, 8-8 G3 6-49, 7-5, 7-8, 8-5, 8-8 get display state 9-17, 9-22 get modes 6-17, 6-24, 6-36, 6-39 get option value 6-25 get screen state 9-17, 9-22 get video buffer TOPVIEW compatible 9-23 GL 6-48, 6-49, 7-4, 8-4 GM 6-17, 6-24, 6-36, 6-39 GOV 6-25 GR 6-48, 6-49, 7-4, 8-4 graphics font 3-9 graphics rendition 3-8, 6-54, 6-56, 6-58, 6-59 GRAVE 5-15 GRCM - Graphics Rendition Combination Mode 6-36, 6-59 G sets 7-5, 8-5 H H hard disk 2-8 hardware requirements 1-2 hashing 3-7, 3-11 Heath H19 emulation 1-6 HEM - Horizontal Editing Mode 6-36 (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE highlighting 10-7 adding 10-5 deleting 10-9 margins 10-5 moving 10-5 removing 10-5, 10-6 Home 10-3 home position 6-54 horizontal and vertical position 6-39 horizontal editing mode 6-36 horizontal position absolute 6-38 horizontal position relative 6-38 horizontal retrace delay 3-11 horizontal tab 6-38 horizontal tabulation set 6-39 HPA - Horizontal Position Absolute 6-38 HPR - Horizontal Position Relative 6-38 HT - Horizontal Tab 6-38 HTS - Horizontal Tabulation Set 6-39 HVP - Horizontal and Vertical Position 6-39 I I IBM-GM 6-39 IBM-KKR - Keyboard Key Reassignment 6-41 IBM-PC line drawing character set 7-9, 8-9 IBM-RM - IBM Reset Mode 6-42, 6-44 IBM-SM - IBM Set Mode 6-42, 6-44 ICH - Insert CHaracter 6-45 ID - IDentify 6-45 identify 6-45 IL - Insert Line 6-45 incompatible computers 13-20 incompatible programs 13-16 increment option value 6-25 IND - INDex 6-46 index 2-1, 6-46, 13-1 initializing crt controller 3-12 initial state 6-54 INLM - INterLace Mode 6-46 insert character 6-45 insert line 6-45 insert mode 6-46 installation detecting FANSI-CONSOLE 4-4 installation options 3-2 installing FANSI-CONSOLE detailed 3-3 simple 2-3 interlace 6-46 interlace mode 1-9, 2-4, 3-9 internal parameters 3-12 (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE interrupt keyboard 9-3 screen 9-11 interrupt vector reservation violation 4-3 inverse video 6-60, 6-61 invoking 7-10, 8-10 invoking character sets 7-5, 8-5 IRM - Insert-Replacement Mode 6-46 ISO 2022 control sequences 7-1, 8-1 ISO 6429 5-4 J J joke 2-1, 2-11, 14-1 just DOS macro enable 3-13 K K KAM - Keyboard Action Mode 6-47 keyboard BIOS calls 9-3 software interrupt 9-3 keyboard action mode 6-47 keyboard disable 6-20, 6-47 keyboard enable 6-23, 6-47 keyboard key click duration 1-11, 9-4 keyboard key click frequency 1-11 keyboard key click repeats 1-11 keyboard key read 9-4 keyboard key ready 9-4 keyboard key rearrangement 11-3 keyboard key repeat delay 9-4 keyboard key repeat rate 1-10, 9-4 keyboard key shift state change 9-5 keyboard key shift state status 9-4 keyboard key status 9-4 keyboard language 3-13, 9-5 keyboard macros 6-41, 11-7 keyboard replacement strings 11-7 keyboard type ahead buffer adding to 9-5 key buffer flush 2-16, 2-17 key pad alternate mode 6-47 key pad numeric mode 6-47 key reassignment 6-41 key repeat delay 2-15 key repeat rate 2-15 key values table 9-5 (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE KKR - Keyboard Key Reassignment 6-41 KPAM - Key Pad Alternate Mode 6-47 KPNM - Key Pad Numeric Mode 6-47 L L language keyboard 3-13, 9-5 left 6-9, 6-12, 6-13 length keyboard key click 1-11 LF - Line Feed 6-48 light pen 9-14 limitations 13-5 line delete 6-19 line drawing character set 7-9, 8-9 line erase 6-22 line feed 6-48 line feed new line mode 6-50 line insert 6-45 literal next character 6-20 LNM - Line feed New line Mode 6-50 loadable device driver 3-1 local mode 11-10 macros 11-11 lock true caps 1-6 locking scroll 1-6, 2-16, 2-17, 3-14, 10-1 locking shift 6-48, 6-49, 6-54, 6-56, 6-64, 6-67 LPTn: 6-50 LS0 - Locking Shift 0 6-48 LS1 - Locking Shift 1 6-48 LS1R - Locking Shift 1 Right 6-48 LS2 - Locking Shift 2 6-49 LS2R - Locking Shift 2 Right 6-49 LS3 - Locking Shift 3 6-49 LS3R - Locking Shift 3 Right 6-49 M M macro enable just DOS 3-13 macros 6-41, 11-7 local mode 11-11 scroll recall feature 11-11 manual 2-5, 2-6, 15-8 maximum recall lines 3-21 MC - Media Copy 6-50 memory limit 3-16 (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE memory requirements 1-2, 2-10, 3-16, 3-21, 3-32 mnemonics table of ANSI X3.64 control sequence 6-75 mode local 11-10 scroll recall 10-1 modes screen display 6-42, 9-12 mode selection 6-8, 6-10, 6-11, 6-17, 6-18, 6-19, 6-20, 6-23, 6-24, 6-25, 6-26, 6-27, 6-32, 6-35, 6-36, 6-39, 6-41, 6-42, 6-46, 6-47, 6-48, 6-49, 6-50, 6-52, 6-53, 6-54, 6-56, 6-58, 6-59, 6-64, 6-65, 6-67, 6-69, 6-71, 6-72, 6-73, 6-74 mode state display 10-2 N N names table of control sequence 6-2 NEL - NExt Line 6-51 next line 6-51 next page 6-51 normal keyboard 11-2, 11-4, 11-6 NP - Next Page 6-51 O O one finger pause 3-14 one finger typing 1-6, 3-18 options installation 3-2, 3-3 ORIG - ORIGin mode 6-52 origin mode 6-52 OSC - Operating System Control 6-51 output redirection 4-3 overlap 3-19 P P P1 5-16 P2 5-16 P3 5-16 P4 5-16 page screen 6-51, 6-52, 9-14 page overlap 3-19, 10-3 palette set 9-16, 9-18 parallel port 6-50 parameter 3-2 (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE parameters 5-16 installation 3-3 internal 3-12 PASCAL control sequences 5-21 pass through BIOS calls 9-5, 9-24 pause 1-6, 2-16, 2-17, 3-14, 10-1 Pg-Dn 10-3 Pg-Up 10-3 Pi 5-16 pixel read 9-17 write 9-16 PM - Privacy Message 6-52 positioning unit mode 6-53 PP - Previous Page 6-52 prefix 6-12 previous page 6-52 primary auxiliary device 6-50 primary graphics rendition 6-58, 6-59 printed user manual 15-8 printer 6-50 printing scroll recall lines 10-8 print screen alternate 9-22 print spooler 2-10 problem Alt-Ctrl-Ins causing breakpoint in wrong place 12-1 Alt-Ctrl-Ins does not work 12-2 Alt-Ctrl-Return does not work 12-2 any kind 13-1 AT&T 6300 hangs 3-27 bad or missing FCONSOLE.DEV 2-19 bad or missing FCONSOLE.DEVLE.DEV 2-9 BASIC escape sequences get displayed 5-19 beeps and does not delete recall lines 10-9 black and white only 6-44 black screen 6-62 blank screen 9-23 blinking 3-7, 3-20 character is not displayed 6-20 characters overwritten 3-29 characters written in wrong place 3-29 clone problems 2-9 colors do not change 2-14 control sequence is displayed and not done 5-18 Ctrl-P key 2-14 Ctrl-PrtSc key 2-14 Ctrl-X key 2-14 cursor color 6-63 cursor missing 6-43, 9-12 Data General One keys do not all work properly 3-27 DEJAVU cannot find FANSI-CONSOLE 10-11 (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE delay before prompt 2-14 Dvorak layout on AT is wrong 11-6 ECHO control sequence does not work 5-7 EGA does not work 3-12 environment space 2-14 escape key 2-14 FCON: does not expand HT characters 4-4 file accesses increase 2-10 flashing 3-7, 3-20 FLAYOUT cannot find FANSI-CONSOLE 11-6 FLAYOUT does not work with keyboard macro program 11-6 flicker 3-7, 3-9, 3-20, 6-46 FORMAT does not work 2-12 hangs during startup 2-10 hashing 3-11 how to check for interactions 13-3 how to check that FANSI-CONSOLE is cause 13-2 INS status word is wrong 10-2 installation 2-11 INT 29 hex does not expand HT characters 5-23 keyboard keys no replaced 6-41 keyboard lights do not light 3-27 keyboard macro program confused 11-15 key does not work 2-17 lack of memory 13-2 MAD-1 keys do not all work properly 3-27 memory usage 2-10, 13-20 not enough memory 2-10 Olivetti M24 hangs 3-27 print screen does not print all the lines 9-22 prompt does not set colors with echo off 2-14 reentering scroll recall behaves strangely 10-7 same without FANSI-CONSOLE 13-2 screen save does not work on Zenith 150/160 3-27 screen save generates weird screen 3-24 screen save only turns off cursor 3-24 scroll-lock key 3-14 Scroll-Lock light does not work correctly 3-14 scrolled lines are not saved 10-3, 10-4 scroll recall does not work 10-1 scroll recall lines not deleted 10-9 SEND creates a file 5-10 SEND does not work 5-10 slow 10-4 slower 2-9 slower on clone 3-11 slow scroll 3-7 snow 3-11 status line missing 10-2 strange shape characters 3-9 tab stops do not get set right 6-38 Tandem PC keys do not all work properly 3-27 TANDY 1000 keys do not all work properly 3-27 TRAP causes infinite loop 13-24 (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE TYPE does not display file contents 2-15 unreadable characters 3-17 using a file/directory named like FCON.xxx 4-4 VT100 mode not recognized by host 11-15 wrong colors after program ends 2-13 programming control sequences 5-18 programming error 13-5 program source 15-11 PROMPT 2-13 control sequences 5-8 Ps 5-16 PUM - Positioning Unit Mode 6-53 Q Q quick scroll mode 3-20 R R RAM disk 2-9, 2-10, 3-2 rate keyboard key repeat 1-10, 9-4 raw mode 6-38 RAWMODE.MAC 2-5 RC - Restore Cursor 6-53 RCC - Report Cursor Content 6-53, 9-15 RCP - Restore Cursor Position 6-54 read dot 9-17 read keyboard key 9-4 README.NOW 2-3 read pixel 9-17 read screen character and attributes 6-53, 9-15 ready keyboard key 9-4 rearrangement of keyboard keys 11-3 recall buffer 10-1, 10-3 recall line maximum 3-21 recall status line 3-19, 10-2 recall viewing screen 10-1, 10-2 redirection 4-3, 13-23 reentering lines 10-7 removing FANSI-CONSOLE 2-19 REP - REPeat 6-54 repeat character 6-54 repeat delay keyboard key 9-4 repeat keyboard keys 6-56 repeat rate keyboard key 1-10, 9-4 repeats (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE keyboard key click 1-11 replacement mode 6-46 replacement strings 11-7 report 6-11, 6-16, 6-21, 6-53, 9-14, 9-15 report cursor content 6-53, 9-15 reset modes 6-17, 6-26, 6-42, 6-56 reset to initial state 6-54 restore cursor position 6-54 retrace delay horizontal 3-11 vertical 3-25 return 6-12 reverse index 6-54 reverse video 6-60, 6-61 RI - Reverse Index 6-54 right 6-14 RIS - Reset to Initial State 6-54 RM 6-26 RM - Reset Mode 6-17, 6-42, 6-56 ROM BIOS 1-10, 2-9 ROM BIOS calls 9-1 keyboard 9-3 screen 9-10 TTY calls ANSI X3.64 3-24 royalty 15-1 RPT - auto RePeat keys 6-56 S S Sav 10-3 save cursor position 6-56 saving scroll recall lines 10-10 SC - Save Cursor 6-56 SCP - Save Cursor Position 6-56 screen BIOS calls 9-10 software interrupt 9-11 screen display mode 3-7, 3-9, 3-11, 3-25, 3-29, 6-42, 6-44, 6-59, 9-12 screen display redirection 4-3 screen erase 6-22 screen mode 6-58 screen page 6-51, 6-52, 9-14 screen print alternate 9-22 screen save timeout 1-8, 3-23, 3-31 screen state get 9-17, 9-22 screen writing 1-3 screen writing methods 4-1 SCRN - SCReeN mode 6-58, 6-59, 6-60, 6-61, 6-62 Scroll-Lock 1-6, 2-16, 2-17, 3-14, 10-1 (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE scroll down 6-58, 9-15 scrolling 6-19, 6-45, 6-46, 6-48, 6-50, 6-51, 6-52, 6-54, 6-58, 6-64, 6-67, 6-68, 6-69, 9-15 scrolling region 1-5, 6-68 scroll left 6-64 scroll lock 1-6, 2-16, 2-17, 3-14, 10-1 scroll recall feature 1-6, 3-14, 3-19, 3-21, 10-1, 10-5, 10-8, 10-9, 10-10 macros 11-11 scroll right 6-67 scroll slow 3-7 scroll up 6-69, 9-15 SD - Scroll Down 6-58, 9-15 secondary auxiliary device 6-50 SEND control sequences 5-9 SEND.EXE 2-5, 5-9 serial port 6-50 set colors 9-16, 9-18 set graphics rendition 6-54, 6-56, 6-59 set modes 6-18, 6-27, 6-42, 6-65 set option value 6-32 set palette 9-16, 9-18 set scrolling region 6-68 setting up FANSI-CONSOLE simple 2-3 SG094 7-8, 8-8 SG194 7-8, 8-8 SG196 7-8, 8-8 SG294 7-8, 8-8 SG296 7-8, 8-8 SG394 7-8, 8-8 SG396 7-8, 8-8 SGR - Set Graphics Rendition 6-36, 6-42, 6-59 shape cursor 9-13, 9-14 shift locking 6-48, 6-49, 6-54, 6-56, 6-64, 6-67 single 6-69 shift keys 1-6, 3-18 shift lock 1-6 shifts 7-10, 8-10 shift state change keyboard key 9-5 shift state status keyboard key 9-4 SI - Shift In 6-64 single shift 6-69 site licenses 15-7 size cursor 9-13 SL - Scroll Left 6-64 slow 3-26, 3-29 slow scroll 3-7 (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE SM - Set Mode 6-18, 6-42, 6-65 snapshot 10-4 snow 3-7, 3-11, 3-26 SNOW.COM 2-5, 3-3 Snp 10-4 SO - Shift Out 6-67 software interrupt keyboard 9-3 screen 9-11 source program 15-11 SP 5-15 speed 3-26, 3-29 SPIT.EXE 2-5, 5-5 SR - Scroll Right 6-67 SS2 - Single Shift 2 6-69 SS3 - Single Shift 3 6-69 SSR - Set Scrolling Region 6-68 ST - String Terminator 6-69 STANDARD.LAY 2-5, 11-3, 11-6 standard keyboard 11-2, 11-4, 11-6 standards 5-25 starting state 6-54 status keyboard key 9-4 status line 3-19, 10-2 status report 6-21 sticky shifts 1-6 string terminator 6-69 SU - Scroll Up 6-69, 9-15 switches installation 3-3 syntax table of ANSI X3.64 control sequence 6-80 system disk 2-8, 2-12 T T tab 6-10, 6-38, 6-73 tab stop clear 6-13 set 6-13 tabulation clear 6-71 TBC - TaBulation Clear 6-71 teletype write 9-17 terminal emulation 1-5 text movement 6-16, 6-19, 6-45, 6-46, 6-48, 6-51, 6-52, 6-54, 6-58, 6-64, 6-67, 6-68, 6-69, 6-72, 9-15 TILDE 5-15 timeout screen save 1-8, 3-23, 3-31 TM 6-35 TM - Toggle Mode 6-19, 6-71 (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE toggle modes 6-19, 6-35, 6-71 TOPVIEW compatible get video buffer 9-23 update video display 9-24 transmit off 6-74 transmit on 6-74 TRAP.COM 2-6, 13-24 trial period 15-3 TTY BIOS calls ANSI X3.64 3-24 TTY write 9-17 turn off 6-17, 6-18, 6-19, 6-26, 6-27, 6-35, 6-56, 6-65, 6-71 turn on 6-17, 6-18, 6-19, 6-26, 6-27, 6-35, 6-56, 6-65, 6-71 type ahead buffer 1-7, 2-8, 13-16 adding to 9-5 type ahead flushing 1-7, 2-16 type ahead limit 1-7 U U underlining 6-60, 6-61 underscoring 6-60, 6-61 unhighlighting 10-5, 10-6 uninstalling FANSI-CONSOLE 2-19 unit mode 6-53 UNSQZ.COM 2-6 up 6-11, 6-15 UpArrow 10-2 updated versions 15-9 updates 15-10 update video display TOPVIEW compatible 9-24 user manual 2-5, 2-6, 15-8 using FANSI-CONSOLE simple 2-16 V V VEM - Vertical Editing Mode 6-72 verify distribution diskettes 2-3 versions 13-6 vertical editing mode 6-72 vertical position absolute 6-72 vertical position relative 6-72 vertical retrace delay 3-25 vertical tab 6-73 vertical tabulation set 6-73 volume keyboard key click 1-11 VPA - Vertical Position Absolute 6-72 (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting FANSI-CONSOLE _____________ FANSI-CONSOLE VPR - Vertical Position Relative 6-72 VT - Vertical Tab 6-73 VT100 emulation 1-5, 11-13 VT100 key table 11-14 VT100 line drawing character set 7-9, 8-9 VT52 emulation 1-6, 6-8 VT52 mode 6-8 VTS - Vertical Tabulation Set 6-73 W W WATZITBE.COM 2-6, 13-25 WATZITDO.COM 2-6, 13-25 window 1-5, 1-12, 6-68 WORDSTAR.PCH 2-6 word wide screen move 3-26 WRAP - auto WRAP mode 6-73 wrapping mode auto 6-73 write dot 9-16 write pixel 9-16 write screen character and attributes 9-16, 9-17, 9-23 write teletype 9-17 write TTY 9-17 writing 1-3 writing control sequences 5-18 writing methods screen 4-1 X X xmit off 6-74 xmit on 6-74 XOF - Xmit OFf 6-74 XON - Xmit ON 6-74 Z Z Z100 emulation 1-6 (C) Copyright 1984-86 Hersey Micro Consulting (C) Copyright 1984-86 Hersey Micro Consulting 
